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IMPORTANT 



Read This Notice 



Any warranty that may exist on any TRS- 
80 computer hardware product that has 
been modified, altered, or has the seal 
broken is VOID. 

Any software or computer hardware modi- 
fications are done at your own risk. 
Neither the PUBLISHER nor the 
AUTHOR assumes any responsibility or 
liability for loss or damages caused or 
alleged to be caused directly or indirectly 
by applying any modification or alteration 
to software or hardware described in this 
book, including but not limited to any 
interruption of service, loss of business, 
anticipatory profits or consequential 
damages resulting from the use or opera- 
tion of such modified or altered computer 
hardware or software. Also, no patent 
liability is assumed with respect to the use 
of the information contained herein. 
While every precaution has been taken in 
the preparation of this book, the 
PUBLISHER and the AUTHOR assume 
no responsibility for errors or omissions. 

The reader is the sole judge of his or her 
own skill and ability to perform the modi- 
fications and/ or alterations contained in 
this book. 



The below statement is the apparent 
policy of the TANDY CORP. and its 
subsidiary RADIO SHACK as under- 
stood by the publisher. The following 
statement is not endorsed by the TANDY 
CORP., but is presented for the reader's 
information and as a warning regarding 
the consequences of modifying or altering 
the TRS-80 computer hardware in any 
way. IJG, Inc., assumes no responsibility 
for the accuracy of the following statement 

The reader is warned that it is the apparent 
policy of the TANDY CORP. and its 
subsidiary RADIO SHACK to refuse re- 
pair service on any TRS-80 computer 
product that has been modified or altered 
in any way whatsoever. 

However, a Radio Shack Computer 
Service Center, at the discretion of the 
individual Service Center, may repair an 
altered or modified TRS-80 computer 
upon the customer's prior agreement to 
pay any additional charges that may be 
incurred to remove or repair any and all 
alterations or modifications that may 
exist and thereby return the computer 
hardware to factory specifications. 
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Preface 



Preface 



A few years ago, when CB was king, a company 
riding high with those 10-4's hesitantly 
announced a very expensive new product. A few 
typed sheets with hand drawings were all store 
sales personnel had to explain this small 'home 
and business computer'. Neither Tandy nor we 
few first customers had any idea that the TRS-80 
would become the first true home computer, the 
Model T of the microprocessor age. 

There's no question that the 'Trash-80' carries 
the burden of some weak engineering and 
corner-cutting decisions made at the time of the 
CB decline, when this personal computer could 
have been Radio Shack's Waterloo instead of its 
new Wunderkind. But, like Rabelais's 
Gargantua, the new child soon outgrew its 
expectations - as well as its clothes. 

And so everyone from the inner sanctum of the 
Tandy Corporation to the cluttered backrooms 
of a thousand hobbyists began the attempt to 
keep this new child content and amused. Thus 
was born the custom TRS-80. From the very 
beginning, and from seemingly nowhere, came 
forth educated hordes who would prod, poke, 
paint, primp, and prime this humble computer 
into becoming more than itself - a 
five-hundred-dollar supercomputer. 

The machine couldn't always do it. Tandy 
took the rap, but also took the cash. Bruised and 
broken 80's littered the electronic landscape, yet 
also unrecognizably modified TRS-things took 
on tasks as diverse as business accounting, 
industrial control, and music making. 

In this book, pathways to creating your own 
customized TRS-80 will be explored. The 
machine will be added to, opened and altered, its 
software patched, its uses expanded, and its 
breakdowns cured. If you expect that your 
personal computer can do more than a fancy 
game of video violence, then I hope you will join 
me in these explorations. 

As this book was completed, Tandy announced 
that the TRS-80 - now called the Model I - is 
history. Production has ended, and that's a good 



thing. The pressure is now off; there is no more 
Trash-80 to defend, but there still is a TRS-80 to 
put to use. 

This book has been put together to please 
everyone. Of course it will not. Although I can't 
expect to help lead each of you through the 
intricacies of a TRS-80, 1 hope that, whether your 
wish is to jump right in and solder every wire or to 
learn slowly and deliberately the theory and 
practice of the machine, you can gain some 
insight from this volume. 

Chapters have been arranged with basic theory 
and concepts toward the front. Special sections 
discussing the computer's software have been 
included to add some dimension to the concepts, 
and some of my own opinions, thoughts and 
tirades have been boxed throughout the text. 

I have seen and used nearly all the commercial 
products presented in this book; comments, 
therefore, are based on first-hand knowledge, 
unless otherwise noted. 

I have attempted in the appendices to present 
lists of those suppliers, publishers, terms, etc., 
that every TRS-80 user might want to know and 
not know how to find. 

As the TRS-80 joins the computer museum 
along with the ENIAC, UNIVAC, IBM 370, and 
others, it still holds a more special place than 
many of those - with possibly half of million of its 
kin in use in the United States, Canada, Great 
Britain, Australia, Germany, and other 
countries. With that in mind, this book may need 
an occasional update. 

I would appreciate receiving updated 
information, corrections, suggestions and 
criticism. Though I cannot promise a personal 
answer, those suggestions will be reflected in 
future printings of this book. 

Dennis Bathory Kitsz 

Roxbury, Vermont 

February 1981 
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Introduction 



The Tools You Will Need 

Your basic TRS-80, with some attachments 
and software, is a thousand-dollar item. So I'll 
not encourage you to use dime-store tools. Buy 
the best you can afford, keep them clean, and 
reserve them just for use on the '80. Don't double 
up tools with the family auto. You may not need 
them all, but here is my customizer's toolbox: 

A medium-sized flat-blade screwdriver 

and Phillips blade screwdriver (a 

reversible combination is ideal). With 
these you open cases and remove cabinets. 

A jeweler's set of flat and Phillips blade 
screwdrivers; hex nut drivers are optional. 
These drivers can be used to align tape 
heads, help make delicate wire bends, 
adjust trimmer controls and even repair 
watches. 

One very thin screwdriver for lifting 
integrated circuits out of sockets. This will 
be its only purpose, but the first time you 
break the pins off a $10 jumper cable, you'll 
wish you'd used it! 

Small scissor-type cutters (manicuring 

types are excellent). These will be used for 
snipping leads in tight spots. 

Small diagonal wire cutters and/or front- 
cutting 'nippers'. Your general purpose 
cutters. They are fast and easy to use, but 
not to be used for heavy wire around the 
house. 

Needlenose pliers (two pairs, normal and 
90-degree types). You'll need these for 
bending leads, also extracting bits and pieces 
you've dropped into a nest of wiring. 



An X-acto type knife, with a strong blade 
and handle you feel comfortable with. Since 
this will be used to cut delicate solder traces, 
you should be able to handle it deftly. I use 
a single edged razor blade, but have leather 
fingers! 

A scalpel, if you can get one. For very 
delicate trimming and scraping; a dental 
pick for pulling off solder balls or lifting 
parts off a board (get this item from an 
obliging dentist — they are often discarded 
when worn); tweezers and needlepoint 
hooks. The latter come in handy for 
tracing incorrect wire-wrapped 
connections. 

Rat-tail, triangular, and flat files. These 
are only for sprucing up the cosmetics, so if 
you don't care how it looks, save a few 
bucks. 

A wire-wrapping tool. The decision on 
this can be tough. If you can afford it, get 
one of the electrically operated slit-and- 
wrap types. Stay away from 'just wrap' 
tools, since they depend on the sharpness 
and quality of the sockets; also they are 
useless for wrapping capacitors or resistors. 
I use a simple double-ended tool sold by 
Radio Shack for about $5. It wears out 
after a thousand or so connections, but it 
fits my hand well, and is not clumsy like 
some electric units. 

A soldering iron. The decision is not easy. 
Should you spend top dollar and get an 
expensive one or buy a cheap unit that can 
be discarded when it wears out? I use a $5 
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To help you prepare for each project, the 
following graphic symbols have been used as a 
key to the tools needed for each project: 






Phillips screwdriver 



Flat-blade screwdriver 



Sockets 



JCS 







Thin lifting tool 



Scissors type cutters 



Solder 



Wire cutters 



Needlenose pliers 



soldering iron which can be junked when it 
gets beat, but my editor uses the best he 
can get (a $30 temperature-controlled one). 

I file a set of $1 tips to my satisfaction, and 
lubricate the threads with white heat sink 
grease. This way I have a few different tips 
at my disposal; with plated bits you never 
file the tips. 

A Multimeter. The voltage regulators in 
your TRS-80 are very good, so any 
problems will usually show up as gross 
errors. This offers you a way out of buying 
an expensive multimeter; for most of these 
projects, the $10 pocket variety will suffice. 
However, for lots of repair work a better 
meter is in order; I use a $40 type (not 
digital!) for my work. 

An oscilloscope. For the projects, no. But 
for repairs, yes. Don't panic thinking of a 
thousand dollars for a digital scope, 
because an old color television scope will do 
perfectly well; they can be found in the 
bargain bins for $50 to $100. If it saves you 











Various files 

Wire wrapping tool 

Soldering iron 
X-acto knife or blade 

Solder wick 

Multimeter 

Oscilloscope 
Drill 



a $100 repair bill, you've paid for it. Mine 
is an old RCA type WO-90Q, built for early 
color TV, and just fine for the bulk of TRS- 
80 work. 

You will also need supplies in the tool box. 
Among these are: 

Solder. Get the best you can afford. 
There's nothing so unpleasant as a great 
glob of the stuff between two traces on a 
board. Order the multicore rosin flux type, 
and stay away from most the off-the-shelf 
stuff. Remember, multicore rosin type 
only, and the finer the gauge the better. 
Never use acid flux solder, as used by 
plumbers and electricians. 

Soldering wick. Marketed under the 
names Spirig, Solder Up and Solder Wick, 
it's a copper braid impregnated with 
soldering flux. When heated with the 
soldering iron it absorbs Solder off the 
board, thus freeing components. Don't do 
without this stuff unless you like fried 
circuit boards and burnt fingers. 
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Wirewrap wire. Also called by the trade 
name Kynar, this is 28- or 30-gauge single- 
strand wire used to interconnect the pins of 
wire wrap sockets. It comes in an 
assortment of colors; get them all, so you 
can keep data, address, power and ground 
lines separate. 

Multiconductor cable. The more flexible 
wire is easier on the coordination, but also 
the most expensive. Best buy is Spectra 
Twist, and its kin, from surplus houses. If 
you need jumper cables, buy them; Making 
a two-ended, 40-pin jumper cable can be 
three hours of maddening work. 

Bus wire. This is solid, uninsulated stuff. 
A small roll will do for a lifetime. I use it 
for wiring, securing bulky capacitors to 
circuit boards, holding bundles of things 
together and for making special tools. 

Miscellaneous. Sockets, perforated board, 
mounting hardware, and such will always 
be needed. 

Details about supplies needed for each project 
in this book will be presented with the project. 
Except for integrated circuits, most of the items 
are available right off the shelf at a local Radio 
Shack or other electronics supply house. 

Schematics 

Schematic drawings of electronic circuits are 
identical to maps. They show routes, direction, 
junctions, relative importance and functions of 
locales, two-way and one-way streets, traffic flow 
and congestion and so forth. At first, the symbols 
may seem like the mysterious hieroglyphics of a 
secret society, but their symbolism can soon 
become as familiar as a roadmap. Even strange 
places can be assessed from afar. 

First, the symbols. A line is a wire running 
from some point in the circuit to another. 
Consider the sketches below: 



The first drawing is a simple wire. The 
electrical path moves from one point to another, 
in either direction. By following the path of a 
wire through a circuit, the pattern of connections 
can be discovered. When wires are forced to cross 
one another, but not to connect with each other, 
it must be made clear. On a roadmap, 
non-intersecting roads are shown either by a 
break in one of the intersecting lines, or in 
showing interstate highways, merely by crossing 
one 'below' the other in a different color. 

Sketches b, c and d are the three ways of 
drawing wires which do not connect to each 
other. The first, simply crossing them, is the 
most common. The second method places a 
semicircular bump in the crossing path, and is 
used by Sams Publications in this country and 
commonly in Europe. Occasionally the broken 
path crossing shown in sketch d is used. 

When wires connect, a dot is used to clarify 
that a connection is to be made. Occasionally, 
you may come across earlier schematics which 
use the 'bump' method of showing unconnected 
wires. On these schematics, the lack of a bump 
indicates wires are connected. 

The wires (or patterns of copper etched on 
circuit boards) connect electronic components. 
Some of them are: 



RESISTOR 



CAPACITORS 




_L+_L 

r POLARIZED 



DIODE 



FET TRANSISTOR 



B«- 



C9- 



s\ 



0©- 



E«- 



Since this is a lesson in reading schematics and 
not electronic theory, I recommend that you turn 
to an excellent book by Forrest Mims, 
'Engineer's Notebook', sold by Radio Shack, for 
an introduction to what each of these parts does. 
Briefly, the symbol for a resistor has the flavor of 
a long wire being compressed, meaning the 
electrical flow is somehow being resisted. The 
innards of a capacitor generally consist of metal 
foil separated by a non-conducting paper or 
plastic, and the capacitor's schematic symbol is 
fairly representative, with two plates facing each 
other but not joining. 



10 



Introduction 



Schematics 



Some capacitors are designed to fit into a 
circuit in only one direction; the positive (+) sign 
identifies that direction. These capacitors are 
identified on their bodies by a positive or 
negative sign. Another one direction (polarized) 
device is the diode. It consists of an arrowhead 
striking a barrier, implying that current may flow 
in the direction of the arrowhead, but not back 
across the plate. The body of a diode may have 
the diode symbol imprinted on it, or a band to 
indicate the 'barrier' end. 

The transistor usually has three connections 
(such connections are called 'leads' on small 
parts such as these). These leads are identified as 
collector, base and emitter or source, gate and 
drain, depending on the transistor type. This will 
be shown on the diagram, and the transistor will 
be imprinted with the information, or it will be 
provided on the package in which the transistor 
is sold. 

A few other symbols are: 



TRANSFORMER 



-y4sr- 



VARIABLE RESISTORS 



y 



-^AAr- 



'D' 



CRYSTAL 
VARIABLE CAPACITORS 

The first is a transformer, whose job it is to 
take current fed into one coil and induce that 
current into a second coil. An iron or ferrite 
center (the parallel lines in the symbol) aids in 
efficient transfer of that current. 

The next three symbols look like resistors and 
capacitors, which they are. The added arrows 
show that their values may be varied; hence, they 
are called variable resistors and variable 
capacitors. The variable resistor is best known as 
the volume control on a television, and the 
variable capacitor is found as the tuning control 
on a table radio. 

The last symbol is a crystal, a piece of cut 
quartz capable of vibrating (resonating) under 
certain electrical conditions. Because a crystal is 
a very accurate, fixed, molecular device, it is 
capable of resonating (also called oscillating) at 



precise intervals. It is used for the master control 
of all pulses in the TRS-80. 

A few directional symbols are now in order: 
GROUNDS 



EARTH CHASSIS COMMON 



POWER 



+5 



T 



PAD 



The first are known as grounds, and they are 
used to indicate a potential of zero or neutral 
voltage. The first of the trio is an earth ground, 
commonly used in radio, television and hi-fi 
schematics, but purists use it only to describe an 
actual connection to a ground spike or cold water 
pipe. The second is a chassis ground, indicating 
an electrical connection to the metal case which 
encloses the circuit. It is often (though 
incorrectly) interchanged with the earth ground. 

The last of the three grounds is a 'common' or 
neutral ground, and the one which is used to 
indicate the zero voltage line in the computer. 
All other voltages within the computer system 
are described in terms of their relation to this 
ground. 

The next quartet of symbols indicate power. 
The up arrow generally points to an actual 
voltage value (such as +5 or +12).The horizontal 
line indicates merely a 'high' level, that is, a 
connection is made to the normal positive power 
supply for the circuits in the system (+5 volts in 
the TRS-80). 

Non-positive voltages have no standard 
symbols. Negative (or below ground) voltages 
can have either a horizontal arrow or a down 
arrow, pointing to the voltage desired at that 
point. The schematics tells you that a connection 
is made to the voltage level shown! 

Another use of a horizontal arrow is to point to 
important connections to be made elsewhere on 
the schematic or on other sheets of the schematic. 
In the former case, the arrow is used because 
actually drawing the wire may clutter the 
schematic, making it illegible. When you see an 
arrow, be sure to find the other end of the 
connection described (indicating words such as 
'clock', 'mem' or 'port FF' may be used as guides 
to where the connection is made). 
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Another useful symbol is the last of the group 
above, the pad. It indicates a significant 
connection, usually to another device or circuit 
board. Using this symbol makes it clear that the 
connection is to be made somewhere off the 
board on which you are working. In this book, I 
have not used these symbols where indicating a 
connection to the TRS-80; instead, the cable to 
the TRS-80 is shown with the connecting wires 
striking a wide vertical band marked 'TRS-80 
Edge Connector'. Other types of off-board 
connections, however, are shown with the pads. 

The most common families of parts found in 
computer circuits, however, are shown below: 



o- 



€> 



AND 



OR 



C^ 



o 



NAND 



BUFFER (a) 



NOR 



lb) 



P~ 



INVERTER 

These symbols represent integrated circuits, 
those multiple lead, buglike packages that 
handle the bulk of the work in the computer. 
Briefly, these are logical building blocks. 
Sometimes there are several blocks in one 
integrated circuit, and these various blocks may 
be scattered throughout the circuit diagram. 
This can be confusing when actually building a 
circuit, but since pin (lead) numbers are given, 
you only have to remember where you put the 
part. 

You should know that the TRS-80 Technical 
Reference Handbook uses what are called 
'functional' schematic elements, meaning 
identical parts are not necessarily drawn the 
same throughout the schematic. I have chosen 
not to use this method, which, although it makes 
circuit operation less evident, is clearer when 
doing actual wiring. 

Complete logical and physical diagrams of 
every circuit used in this book are give in an 
appendix. Those diagrams will help give you an 
idea of how these logical blocks are packaged 
inside 8-, 14-, 16-, 18-, 20-, 24-, 28- and 40-pin 
cases. 



Basically, that covers reading a schematic 
roadmap. Below is a section of circuit. See how 
the logic elements are connected to each other as 
well as to two resistors, a capacitor and a crystal. 
Notice also that the logic elements are all marked 
'Z19', since they are separate blocks within a 
single component. An arrowhead indicates a wire 
leading off the board, and power and ground 
connections are shown. The numbers on the logic 
elements are the pin numbers for the component 
connections: 




R46 

910 



ISHTII 



R52 
910 



•■^74LS04 l0.6445MKr'^74LS04 



TOGGLE 



+ 5V 
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£R63 
54.7K 
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CLOCK 



PRE CLR 
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74LS74 

CLK 5|> 
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Be Tolerant 

Every electronic component is manufactured 
to work within specific limits, whether they be 
accuracy, temperature, speed, power use or other 
limit. These are the components parameters or 
tolerances. The circuits in this book have been 
designed to use the most commonly available 
parts, so the matter of tolerances is rarely 
important. However, sometimes those 
tolerances are important, such as when talking 
about memory speed or power supply voltages. 

Power supply should be within five percent of 
the voltage specified; a supply indicated at five 
volts may vary only from 4.5 volts to 5.5 volts. By 
using the power supply regulators shown in the 
schematics, these voltages should not be of 
concern. Unless you are familiar with power 
supply design, do not attempt to use other 
methods of regulation. 

Very few of the resistors have tolerances noted 
on the schematics. The rule of thumb is one 
quarter watt at five percent, but if you can only 
obtain half watt units, or 10 or 20 percent 
resistors, don't be concerned. The quarter watt 
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resistors are a bit less costly and are a bit more 
aesthetically appealing. Consider also that if a 
resistor is specified as 1,000 ohms, a 20 percent 
deviation gives a range of 800 ohms to 1,200 
ohms. Thus, the standard values of 910 ohms or 
1,200 ohms should do as well. 

Capacitors are notoriously sloppy in their 
tolerances, especially electrolytic types (those 
whose polarity is marked on the schematics). 
These normally vary from 20 percent low to more 
than 100 percent high - thus, when a 500 
microfarad capacitor is noted, it can range from 
400 to 1,000 microfarads. Also, there is some 
revision in the standard numbering method used 
for parts values: 470 microfarads is now being 
called 500 microfarads, for example. So when 
you try to obtain a capacitor value marked in the 
parts list, remember that a nearby higher value is 
fine. 

Voltage parameters for polarized (electrolytic) 
capacitors are important. Never get an 
electrolytic capacitor with a value less than that 
specified, but do not hesitate to take one with a 
higher voltage parameter. That is, a capacitor 
specified at 47 microfarads, 16 volts, can be 
replaced with one specified at 50 microfarads, 35 
volts. It may be physically larger, but it will work 
equally well. 

If you walk into a store and hand the sales clerk 
a parts list, don't be surprised if you are asked a 
few more questions. You might be faced with 
chosing between parts which are identical as far 
as the parts list in this book is concerned, but 
which include other parameters. 

Resistors can be carbon composition, carbon 
film, glass or wire wound. These days, carbon 
film is common and cheap, and that's your first 
choice. Carbon composition is the next choice at 
a lower quality, and glass is excellent but at a 
higher cost. Forget wire wound, because they can 
contribute unwanted side effects. 

Ordinary capacitors are manufactured in 
many ways: ceramic, polystyrene, polyester, 
silver mica, polycarbonate and paper. For the 
bypass capacitors necessary for all the circuits in 
this book, ceramic types are your choice. Cheap. 
If you get silver mica, so much the better, but 
you'll pay a price. Watch out for polystryrenes or 
polyesters if you plan to solder, because they are 
delicate and you can damage them with too much 
heat. Otherwise they are excellent, but quality 
overkill. Polycarbonates are slick types, and you 
might consider using these if you build the 
8-track mass storage system. Run the other way 
if you see paper capacitors. 



Electrolytic capacitors come in two basic types 
- metal cans (covered with plastic), and those 
manufactured using tantalum (an expensive 
metal of great strength and purity). For most 
digital projects, choose the ordinary cans. 
Tantalums of the same value, although smaller, 
high quality, and very pert looking, are costly and 
not required here. 

Digital integrated circuit part numbers are 
generic, which means that a 74LS00 circuit might 
be sold as an SN74LS00 or an NEC-74LS00. The 
prefix characters refer to manufacturers. On the 
other hand, those parts whose numbers contain 
'LS' may not be substituted by parts marked 'S' 
or 'C or by those with no markings. 74LS00 may 
not be replaced by 7400, 74S00, or 74C00, nor 
may they be exchanged for each other. When 
integrated circuits are specified, try not to 
substitute with other circuit 'families'. 

This section will not make you a master 
schematic reader; only practice will do that. Pick 
up copies of the Engineer's Notebook mentioned 
above, as well as various of the project books sold 
by Radio Shack and others. 

Building a Power Supply 

All the projects presented in this book will 
either be modifications to the TRS-80, in which 
case they will draw power from the computer 
itself, or outboard devices which will need power. 
There are several ways to get this power: 

1. Build a power supply from scratch for 
each device, including transformer, rectifiers, 
capacitors and regulators. 

2. Build a main power supply providing 
substantial current at between 7.5 and 15 
volts, and put a voltage regulator and a 
capacitor on board each project. 

3. Use an assembled power supply providing 
a 7.5 to 9 volt output for each project, and 
use a voltage regulator and a capacitor on 
each board. 

4. Use an assembled power supply providing 
5 volts and feed all boards from it. 

My recommendation? Probably an assembled 
power supply of 7.5 to 9 volts feeding each 
project. Power supplies are important to 
projects, and they should be well regulated, free 
of residual 60 Hz (Hertz equals 'cycles per 
second)' ripple, and should not tend to transmit 
signals between projects. Some things to 
consider include: 
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Unregulated positive power supply. 



1. Building a power supply is not very 
time-consuming, but it is probably going to 
be bulkier than the project being 
constructed. Then there's the question of 
where do you put it? If it's in the project, 
you have to be very careful to shield the AC 
primary and secondary leads. Also, you have 
to be sure it's working properly before you 
can begin to test your project. 
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Unregulated bipolar power supply. 
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2. Small, assembled power supplies are 
inexpensive. They are normally sold as 
'battery eliminators', with their current 
capabilities specified. The AC leads are 
encapsulated in plastic with the rest of the 
supply. Although you need a separate 
house-current outlet for each of these 
supplies, the work you do (both building and 
testing) is lessened and the safety to you and 
your project is increased. 

3. Larger power supplies are expensive to 
buy and complicated to build. Unless they 
and each project being fed contain plenty of 
transient suppression (in other words, lots of 
extra capacitors), the actions of one device 
may affect another. But they do tend to be 
more immune to house current fluctuations 
than small homemade or purchased power 
supplies. With regulators on each project, 
moreover, you can provide more immunity to 
spikes and fluctuations. They are truly 
'brute force' circuits. 

4. Large regulated power supplies are highly 
stable, but expensive. They are capable of 
feeding a whole range of boards, less house 
current outlets are needed, and the level of 
regulation is usually substantial enough to 
prevent fluctuations at the board level. 
However, onboard filtering is still necessary 
to prevent interaction among external 
devices. 



The circuit diagrams that follow present a 
simple, unregulated, positive power supply; a 
simple, unregulated, bipolar power supply; a 
regulated five-volt power supply; a regulated 
dual-voltage (+5 and -1-12 volts) power supply; a 
regulated bipolar (+5 and -5 volts) power supply; 
a regulated four-voltage (+12, +5, -5 and -12 
volts) supply, and last (but by no means least) 
the design of the power supply (+12, +5, and -5 
volts) used in the TRS-80. All these supplies can 
use the transformer / rectifier 'power supply' sold 
for the TRS-80 as their source. 
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Power Suppies 

Digital electronic circuits constructed by hand 
can perform as well as neatly-laid-out 
commercial circuits. In some ways, though, 
these circuits have to be designed better than 
commercial ones, because professionally etched 
boards are usually designed with careful 
consideration given to signal paths. Wire- 
wrapping or soldering, on the other hand, can 
look like a rat's nest and sometimes act that 
way. 

Most important: always use bypass 
capacitors in your projects. These are capacitors 
with a value of about 100 nanofarads (0.1 
microfarads), ceramic discs or dipped mylar, 
attached between +5 volts and ground. These 
are physically placed near their respective 
integrated circuits. When I finish wire wrapping 
a circuit, I give it a quick test to make sure the 
wires are connected properly and the circuit 
behaves normally (barring occasional crashes) . 
Then I attach a 100-nanofarad bypass capacitor 
between the positive power supply and ground, 
directly between the wire-wrap pins carrying the 
power. 

Secondly: add termination resistors to the 
data lines whenever more than one project is 
connected to the computer. Termination 
resistors act as electronic clamps, holding the 



lines steady as the signals sweep through. These 
eliminate random noise, as well as signal 
'overshoot', caused by capacitance introduced 
by the wires themselves. If you have an 
expansion interface of the new breed (no 
buffered cable), termination resistors are 
already in place. They are also standard with 
the LNW and Microtek interfaces (though I 
recommend doubling the value suggested by 
LNW, to at least 470 ohms and 1,000 ohms). 

The simplest addition of termination resistors 
involves connecting a 1,000 ohm resistor from 
each data line to ground. To ensure even better 
signal clarity (and also to maintain the 'high' 
level the computer normally sees on its lines), 
also attach a 470 ohm resistor from each data 
line to +5 volts. In all, then, eight resistors will 
be needed for each project you add. 

Finally, do not skimp on the power supply. 
Generally you will see a 2,200-microfarad 
capacitor followed by a regulator, a 470- 
microfarad capacitor and a 100-nanofarad 
capacitor. This is the absolute minimum 
configuration for a working power supply. If you 
have the room, increase the value of the first 
capacitor to 4,700 or 10,000 microfarads, and 
place a 100-nanofarad capacitor between input 
and ground physically near the voltage 
regulator. 



*■ +5V 




»- -12V 



+/-12, +/-5 volt regulated power supply. 
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117 VAC 




TRS-80 transformer adaptor and supply. 



-•• + I2V 




TRS-80 power supply. 
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Those Colors: What They Mean and 
How to Read Them 

The color codes used for resistors, 
capacitors, and other parts are brought to 
you by the same folks that brought you 
phrases like 10W-40 and RS-232C: the 
standards-setting powers of the engineer- 
ing industry. It becomes an international 
shorthand. 

The colors are black, brown, red, orange, 
yellow, green, blue, purple, grey and white. 
If you can't immediately remember that, 
then pick up a piece of multi- conductor 
'rainbow' cable. The colors are all there in 
the same order. The table below presents 
the color codes and how they can be read 
on the bodies of resistors, capacitors, and 
diodes. 



FIRST AND SECOND 
COLOR BANDS 



THIRD COLOR BAND 



BLACK 





BROWN 


1 


RED 


2 


ORANGE 


3 


YELLOW 


4 


GREEN 


5 


BLUE 


B 


VIOLET 


7 


GRAY 


8 


WHITE 


9 



BLACK 

BROWN 

RED 

ORANGE 

YELLOW 

GREEN 

BLUE 

SILVER 

GOLD 




X 
X 
X 
X 
X 
X 



10 

100 

1000 

10,000 

100,000 

1 ,000,000 

100 

10 



FORTH COLOR BAND IS THE TOLERANCE 
GOLD = 5% SILVER = 10% NONE = 20% 



What do these values mean? Resistance 
is a kind of objection to electron flow, 
measured in ohms (pronounced with a 
long O). The abbreviation is a Greek 
omega ( £2 ). Thousands of ohms are kilo- 
ohms, or just kilohms, and abbreviated K 
(k in Europe). Millions of ohms are 
megohms, abbreviated simple M. The 
ability of a resistor to withstand electrical 
current is measured in Watts (W). Most 



computer work is done with 1/4 Watt 
resistors. 

For resistors without color bands, the 
values are stamped on using R (instead of 
omega) for ohms, K and M. 

Capacitance is the inclination of a non- 
conducting object to store an electrical 
charge, measured in Farads. The abbrevi- 
ation is a capital F. Since this is a very 
large amount of capacitance, real work is 
generally done in millionths of Farads, or 
microfarads (mF), and millionths of 
millionths of Farads, called picofarads 
(pF). Since many of the more popular 
capacitance ranges for computer work fall 
between these two figures, the abbrevia- 
Otion for thousandths of millionths of 
Farads, or nanofarads (nF) is common in 
Europe. The ability of a capacitor to 
withstand voltage is measured in voltage 
tolerance (V). 

Capacitance is usually printed on the 
capacitor in mF; color bands are rare. 
Picofarads are marked "p'; the absence of 
an abbreviation indicates microfarads. 
Note that these capacitor 'base values' 
are equivalent: 18=20, 27=30, 39=40, 
47=50. 
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Abbreviations and Conventions Used 
in this Book 

A0-A15 Computer address Lines. 

C A capacitor, specified in the parts 

List; positive and negative sides 

are marked. 
CLK CLock, usuaLLy a fLip-fLop input. 

CLR CLear, usual Ly to fLip-fLop or Latch. 

CR A diode, Radio Shack schematic reference. 

D A diode, specified in the parts List. 

D0-D7 Computer data Lines. 

F Farad; used only as part of mF, uF, pF. 

GND Common computer ground. 

K A relay, specified in the parts list. 

-K Resistance value suffix = x 1000. 

LEO A light-emitting diode, specified in the 

parts List. 
m- Capacitance prefix for x 0.000 001. 

H A motor, specified in the parts List. 

-M Resistance value suffix = x 1,000,000. 

MHz Megahertz (million cycles per second], 

p- Capacitance prefix = x 0.000 000 000 001 

P Piggybacked integrated circuit. 

PRE Preset, usually to flip-flop or latch. 

0. Transistor, specified in the parts List. 

0. FLip-flop or Latch output. 

R A resistor, specified in the parts List. 

S A switch, specified in the parts List. 

T Transformer, specified in the parts list, 

u- Capacitance prefix for x 0.000 001. 

U Integrated circuit (LNW references only). 

Vcc Co L Lector-supply voltage, thet is, the 

'five-volt supply 1 . 
W Watt; resistor power reference. 

X DIP shunt or jumper, R/Sheck reference. 

X Crystal oscilLator. 

Y Demultiplexer output signal. 

Z An integrated circuit, specified in the 

parts List. 
* Used in text references for 'not', in 

pLace of a horizontal bar across the 

top of the abbreviation. 

0V Ground, zero-leveL, or center-ground. 

+5V Five— volt positive regulated power 

supply, the 'Five volt supply 1 . 
-5V 5-voLt negative regulated power supply. 

+12V 12-volt positive regulated power suppLy. 

117V House current, 105-120 volts AC. 

BASIC commands; Z-80 mnemonics and 
opcodes; CPU and other schematic signals 
are printed in UPPER CASE letters. 
Hexadecimal numbering is printed in 
BOLD letters. 
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Getting Inside 

A TRS-80 is the proverbial black box. It's the 
first mass-marketed personal computer that was 
intended for simple home and business use. As 
far as retail sales are concerned - whether it's a 
car, a hi fi, or instant pudding - thinking of it as 
a black box is just fine. "Yes, it's a complete 
computer with a keyboard unit, video display, 
and cassette storage." 

To have this small computer work to even a 
fraction of its potential, though, you've got to 
have the power to control it. As with driving a 
fine automobile, that power comes with 
understanding, comes with being able to look 
through and into the box, comes with keeping it 
carefully tuned and customized so that it can 
respond to your wishes. 

In this Chapter we'll open the electronic black 
box a little at a time. If this is all new to you, 
prepare for some exciting finds inside this box; if 
not, then follow along and discover just how 
much you've learned about microprocessors in 
their own age. 

What You See 

The main computer unit is in a small case 
looking something like a typewriter that has lost 
its carriage. There are 53 keys in a typewriter 
style layout, and perhaps on your unit a numeric 
keypad to the right. Connections on the back are 
marked Power, Video, and Tape, along with an 
on/off switch. 

The unit is entirely silent. It is electronic in 
conception and execution. 

A power supply lowers and isolates the 
120-volt household supply to approximately 
one-seventh that value, and that feeds the 



keyboard unit. An ordinary cassette player is 
cabled in, and a partly disemboweled television 
set plugs in place, serving as a crude video 
monitor. 

The designers of the TRS-80 struggled with, 
and won, the battle of familiarity. Televisions, 
cassette recorders, and typewriters are among 
the most ordinary of home or office appliances. 
But by winning this battle of familiarity, the 
designers also clearly set themselves up to lose 
the battle of reliability (more on that later). 

Let's first take a look at some of the things the 
computer does, and then very generally try to 
discover how and with what the machine does 
them. 

When you power up your computer, you expect 
to be able to communicate with it. Unlike a 
television, it does not entertain, but rather 
evaluates and responds with an electronic 
psyche. If it were not capable of using a 
human-like language, we would be forced to use 
the machine's language. But since it will be asked 
to accomplish human tasks, we will demand that 
it speak a human sort of language - BASIC 
(Beginners' All-purpose Symbolic Instruction 
Code). BASIC has grown since its humble but 
inspired beginnings at Dartmouth College into a 
formidable tool capable of rocking other 
standard languages off their computational 
pedestals. If you have been using your TRS-80's 
BASIC, you know its fluidity. But it does not 
work alone. 

The BASIC that is in the TRS-80 works 
hand-in-hand with the electronics to produce a 
video display for us to read, and to examine a 
keyboard for us to type on. The keyboard gives 
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input to the computer, the video display shows 
output from the computer. Input and output are 
grouped together in computer terms, and are 
collectively called I/O. The tape recorder, which 
saves and loads computer programs, would also 
be called I/O. 



Forget the claims that the TRS-80 computer 
can do what this-or-that state-of-the-art 
computer could do five years ago. Maybe so, 
but it really can't. Because it isn't built like a 
piece of office furniture. Because it doesn't act, 
work, or 'think' the same. No matter how you 
paint it or pad it, a four cylinder sportscar will 
never be a luxury V-8 sedan. And Burger King 
is not a candidate for the four-star list. But 
they can do what they can do as well or better 
because of the simple, direct, streamlined 
nature of their operation and conception. Turn 
away the question of value judgment, and you 
discover that - considering portability, cost, 
ease of maintenance, accessibility and vastness 
of the software domain - the TRS-80 is 
probably a dimension better than that recently 
demised state-of-the-art dinosaur. 



That about covers what we can say about the 
minimal TRS-80 setup - a keyboard computer 
unit with I/O. Before popping off the cover, let's 
name some of the rest of the I/O devices that can 
be hooked up to the machine. Those might 
include: 

An Expansion Box. 

This attachment expands not only the 
internal capacity of the computer, but also 
forms an electronic saddle, permitting other 
devices to ride on the back of the keyboard 
unit. 

A Printer. 

Obviously, an attachment to provide a 
permanent record of the machinations of the 
TRS-80. 

A Diskette Drive. 

A place to store information and programs 
when the computer is turned off; it is very like 
the cassette player, except that it is speedier 
and can be accessed differently. More on that 
later. 

Voice Input/Output. 

An ability to speak and be spoken to on the 
part of the computer. This is one of the 
experimental options. 

Telephone Communications. 

Communications with other computers, 



similar or different, nearby or across the 
world. 

Control Centers. 

The power to change, activate or extinguish 
electrically-powered equipment throughout a 
home or office. 

There are more devices which might be 
considered, including clocks to tell the time of 
day, little circuits to create sound effects and 
music, even other computers used as 'slaves'. In 
fact, where electrically controlled equipment is 
involved, almost anything can be attached 

directly or indirectly to the TRS-80. 

Hesitation 

When you open the computer's case, you'll see 
an enormous amount of electronic circuitry. 
Before you open it though, you should have an 
idea why there are so many integrated circuits 
and circuit board traces connecting them. 

We live in an analog world. We judge size or 
volume or loudness not by how big or full or loud 
it is, but by how big or full or loud it seems in 
relation to something else, even if that 
'something else' is merely what we are used to 
hearing in our normal world. 

In other words, all our evaluations are made by 
analogy. "How big is it?" "As big as a 
basketball!" "Is she pretty?" "Pretty as a 
picture!" "Is it far?" "About a stone's throw 
from the corner." Our cliches are built on 
comparison or analogy. Ideally, then, we might 
like to build a machine that work for us in our 
own terms . . . 

"Machine!" 

"Duh, yessir, sir." 

"Add fourteen and thirty-seven, machine!" 

"Yup, yup. Lessee. Hmmm, fourteen is 
this big. And thirty-seven is this big. 

That makes a number this big 

Sir?" 

"yes, machine?" 

"That's as much as thirty-seven and 
fourteen, sir! Looks just like fifty-one, 
sir." 

"Thank you, machine." 

This computer has a rather limited voice 
capacity, but what it did inside itself was 
electronically quite sophisticated. It took in a 
value and transformed it into an electrical 
voltage of fourteen units, stored it, accepted a 
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second value and transformed it into a voltage of 
thirty-seven units. Then it added the voltages 
together; the resulting voltage worked out to be 
equivalent to a value the size of fifty-one voltage 
units. 

The manufacturers of the real world might be 
able to create electronic parts with this kind of 
accuracy, but chances are that these parts 
wouldn't be cheap. A TRS-80 made with them 
would be worth more than the previously 
mentioned V-8 auto. 

So in the stone age of computer activity, it was 
decided that the simplest level of evaluations 
would have to be made. A low voltage or 'off 
condition would be made equivalent to zero; a 
high voltage or 'On' condition would be set equal 
to one. That was it. All calculations would have 
to be done with ones and zeros - the binary 
system. 

You've probably heard of, and perhaps used, 
binary numbers and there will be more on this 
system later in the book. But the point is that 
you can well imagine that doing work with real, 
human numbers means quite a basketful of the 
individual ones and zeros. Which means, 
consequently, many separate signal lines to carry 
those groups of numbers. 



So Open It Already! 



So Open it Already! 

Turn the power off to your TRS-80 keyboard 
unit and flip over on its front. Carefully undo the 
cabinet, noting the different sizes of screws used 
to fasten it together. Holding the entire 
computer firmly together, again flip it on its 
back. Remove the top cover. Gently lift the 
keyboard forward and remove the five or six 
plastic spacers underneath it; in later 80's, one of 
these will be solid and the rest flexible. Note 
their positions. Now set the keyboard back, lift 
the electronics out of the case and place it on a 
spacious work surface. 

Time out. As you make changes to your 
TRS-80, add memory and the like, you will be 
opening the case many times. Two things might 
happen. First, the keyboard grommets will get 
lost. Their purpose is twofold: to prevent the 
keyboard from shorting against the main circuit 
card, and to cushion delicate parts against a 
constant onslaught of none too gentle typing. If 
you lose them, cut new ones out of bottle corks. 
They'll work just fine. 

Another more difficult problem is the 
keyboard cable itself. This is a band of springy 
copper leads covered with white plastic located 
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Photo 1-1. The TRS-80 opened and spread out 
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Photo 1-2. Closeup of keyboard cable area 
Complete TRS-80 spread out for cable replacement Other 
visible changes include Level I/II switch on keyboard (bottom 
right of keyboard), new Level II interconnect cable (center), 
additional keyboard socket (top left), and external reset switch 
connector (bottom left). 

at the bottom left of the keyboard. It electrically, 
and physically, attaches the keyboard to the 
main circuit board. Very subtle cracks can occur 
in the copper after about a half-dozen flexes. 
Symptoms can be lost letters or odd 
combinations of letters, a system constantly 
crashing or otherwise acting up, constantly 
repeating letters, or complete lockup of the 
keyboard. Avoid flexing this cable quickly or 
bending it sharply. Later we'll replace this cable 
with something better, but for the moment be 
gentle with it. 

Now back to the machine. Spread the two 
sections connected by the keyboard cable out in 
front of you. The keyboard and the top of the 
circuit card will now be visible. The Central 
Processing Unit is a single integrated circuit, the 
Z-80; it is to the far left in the photograph on this 
page. The power supply is the block of 'heavy 
equipment' at the back; the two small 
potentiometers regulate the voltage to within 
five percent, so keep clear of these controls. The 
eight memory circuits are in a row near the power 
section, and the language memory (Level I and 



newer Level II BASIC) is located in the center of 
the circuit card. On most Level II units, this 
language required three integrated circuits, and 
so these were placed on a separate 
two-by-three-inch card taped to the main board 
and connected with a 24-conductor cable. Don't 
be tempted to remove that cable, yet! 

A group of circuits to the bottom left in the 
photograph hold the video image. Two 
important parts are socketed on the board; these 
are marked Z3 and Z71, and they are 
programmable shorting jumpers. What makes 
them programmable is the fact that with a 

gouging tool you can break the connections; not 
very subtle, but it works. Their purposes are 
different - one selects the amount of memory 
available in the keyboard unit, and the other 
selects which of the standard languages (Level I 
or Level II BASIC) is in use. 

At the top left, the video and cassette output is 
controlled. Two small potentiometers on that 
side of the board position the video image on the 
screen, so if you received a TRS with its image off 
center, twiddling these will straighten it out. The 
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Figure 1-1. Z-80 block diagram from Zilog. 



16K RAM Expansion Service Manual and 
Addenda (Order). 

TTL Databook (National Semiconductor). 
Catalog No. 62-1370. This may not be 
stocked anymore; if so you can order it from 
National Semiconductor direct. 

And finally, a Z80-CPU / Z80A-CPU 
Technical Manual should be ordered from 
Zilog, Inc., 10340 Bubb Road, Cupertino, CA 
95014. It costs $7.50. 

These references will not only help you to 
make the modifications suggested in this book, 
but also to understand the operation of the 
computer, bend it to your wishes, and repair it if 
it fails. Additional references which you will find 
valuable are listed in Appendix II. 



remainder of the board is dedicated to 
controlling the complex electronic traffic. 

One last item is the edge card connector, which 
can be viewed at the top right hand side of the 
photograph. Through this connector, the 
TRS-80 may speak to the outside world. Much 
more on that connector later in this book. 

On the keyboard itself there are a few circuits. 
Their job is to assist the Central Processing Unit 
(CPU) in determining which key is pressed. 
These circuits are sometimes remarkably 
sensitive; there will be more about these later. 

Put it Back 

Become familiar with the layout of this board, 
as it will assist you in locating work or repair 
areas. Functions of the computer parts are 
generally grouped together, so modifications will 
usually be restricted to a compact area of the 
board. Once you have a good idea of where 
everything is, put the keyboard unit back 
together carefully. 

To really get to understand your machine you 
will want to obtain, either off the shelf at Radio 
Shack, from a Repair Center, or 'National Parts', 
the following manuals: 

TRS-80 Micro Computer Technical 
Reference Handbook. Catalog No. 26-2103. 

TRSDOS & Disk BASIC Reference Manual. 
Catalog No. 26-2104. 

Printer Cable Service/Installation Manual 
(Order). 

Expansion Interface Service Manual (Order). 
Make sure this includes the FD1771 disk 
controller appendix from Western Digital. 



The Hidden Insides 

It's not much of a mystery to TRS-80 users 
that all that hardware is controlled by software. 
That's one of the first things you learn. But it's 
also as simplistic as saying that the driver makes 
the car go, and just as misleading. Complete 
computers are called 'turnkey' systems because 
they imply simple, appliance-level setup and use. 
But a customized TRS-80 suggests something 
more, and with that 'something more' comes a 
requirement to have a better handle on hardware 
and software. 

Let's define some terms. The TRS-80 is a 
personal computer, which is a popular way of 
saying a small, microprocessor-controlled, 
turnkey computer. The microprocessor, a Z-80, 
is a complicated, general-purpose, electronic 
switching center capable of accepting, changing, 
sending, and re-routing a complex array of 
electronic signals. 

Both the TRS-80 as a whole, and the Z-80 in 
microcosm, have something called architecture. 
Architecture is the overall dimension by which 
these devices define their electronic space. Put 
simply, it is 'how they work'. As with all human 
work, this involves defining tasks and their order, 
executing those tasks, and producing a result. 

In the Z-80, the architecture involves 
accepting electronic signal groups called 
instructions, decoding them into internal 
activities, and executing those activities. An 
arithmetic logic unit (ALU) performs simple 
mathematical functions, internal memory cells 
called registers hold signal information to be 
acted upon, and an internal bus controls the flow 
of electronic traffic. The order of entering signals 
is identified by means of an address, which 
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identifies a fixed numbered slot in the Z-80's 
electronic universe. 

In the block diagram of this activity, shown 
opposite, note the terms '8-bit data bus' and 
'16-bit address bus'. The Z-80 is an integrated 
circuit with 40 external connections. The 
number 40 is arbitrary, chosen because 
manufacturing precision is currently limited to a 
physical 'package' of that size. That precision is 
also central to why the binary system is used, as 
mentioned earlier. 

From the viewpoint of ten-fingered humans, it 
would be simpler to do our computing in familiar 
decimal form. As with the uninspired 
conversation between human and computer 
presented earlier, different levels of voltage 
could be used. But such levels of precision are 
difficult to produce commercially and impossible 
to diagnose when they fail. 

That is the practical origin of the simple 
one/zero, on/off, true-false system of numbering 
used by the computer. To discover how these 
signals are arranged, we now turn back to the 
Z-80 itself and the 40 external pin connections. 
Information put into and called for out of the 
processor is called data, with a simple small 
value of zero. Any reasonable number of pins 
could have been dedicated to accepting data, but, 
based on the amount of work the processor had to 
do, eight of the 40 pins were assigned. This is the 
8-bit (binary digit) data bus. 
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Figure 1-2. TRS-80 memory map. 



Likewise, there is the need to determine the 
order in which the processor is to do its work. In 
order to move from command to command, it 
identifies the order of those commands by their 
position, or address. Sixteen of the Z-80's pins 
are used to specify a number from 0000 0000 0000 
0000 to 1111 1111 1111 1111. 

When the power is turned on, this address bus 
switches to all zeros. The computer fetches its 
first command along the data bus from that 
all-zero location. It executes the instruction, 
fetches the next, and the next, and the next. 

There's certainly more to this, but very 
basically that's the architecture of a 
microprocessor. Address lines for locations and 
order, and data lines for information. Now we'll 
turn to the TRS-80 and its architecture. 

The TRS-80 contains the microprocessor, 
which is the Central Processing Unit (CPU) of 
the computer. Along its address bus is found the 
computer's internal information and instruction 
storage block - its memory. Also along this bus 
will be found video memory, a block which is 
reserved to display information to us on the 
screen; a keyboard, which is given its own set of 
addresses; the BASIC language; some unused 
areas; and single memory slots in which are 
housed windows to the cassette recorder, disk 
drives, printer and so forth. 

This hardware is already familiar, so let's look 
at the hidden insides, the software. The BASIC 
system is found in permanent, Read-Only 
Memory (ROM). It consists of several major 
sections: 

• A keyboard scanning routine to discover 
and interpret activities at the keyboard. 

• A video processing routine which 
presents and updates the monitor 
information. 

• Input/output controls for saving and 
loading program material and operating a 
printer. 

• An interpreter capable of transforming 
the 'English' words which make up the 
BASIC we know, and determining what 
computational actions should be taken. 

• Memory-management systems which 
apportion the computer's available memory 
into blocks which will not conflict. 

• Arithmetic- and text-processing 
subroutines which can perform calculations 
and operations on numbers and 
alphanumeric characters. 
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Overall, the Level II BASIC language requires 
more than 12,000 separate 8-bit groups, known as 
bytes, to perform its work. 

At the end of this Chapter is a detailed look at 
how the software operates from the time the 
machine is switched on to the time you read 
MEMORY SIZE? on the screen. In summary, 
that software disables any signals which might 
interrupt its operation, turns off the cassette 
relay and clears data from that output, restores 
the video screen to 64 characters per line, and 
sets up a block of memory for use by BASIC 
programs. A disk drive is searched for, and if one 
is found, a group of procedures are initiated in 
order that the disk program may take control of 
the TRS-80. 

If no disk drive is found, the screen is cleared 
with blanks, the MEMORY SIZE? prompt is 
displayed, and a keyboard scanning process is 
begun. A valid response to that question is 
accepted, and, if necessary the entire bank of 
memory is tested. Error messages are updated on 
the video screen as needed. Finally, the memory 
size and available room for text strings is created, 
the READY prompt is displayed, and control of 
the TRS-80 is given to the user. 

Power-Up Routines 

The initialization routine of the TRS-80 is a 
complicated and very interesting aspect of the 
computer. It must, of course, set up all the 
parameters that will be used by BASIC 
programs, but it also conducts a series of tests 
and makes hardware adjustments to the device. 

It double checks to assure the proper operation 
of memory, and to be certain that the parameters 
needed for proper operation of programs will be 
present. This section will take a look at the 
initialization process. 

Here are the first few instructions: 



0000 




ORG 


0000H 


0000 


F3 


DI 




0001 


AF 


X0R 


A 


0002 


C3 74 06 


JP 


0674H 



At power-up, the Z-80 chip 'homes in' on 
address 0000, and begins its execution there. The 
first action is significant: DI (Disable Interrupt) 
keeps the clock 'heartbeat', generated by the 
expansion interface, from disturbing any actions 
of the computer - especially important, since the 
necessary software for handling that interrupt 
request is not in ROM, but rather a part of the 
disk BASIC, or what is also offered as 'Level III' 
BASIC. 

So the interrupt is masked out. XOR A is the 
process of 'exclusive-ORing' the accumulator. 



Exclusive OR is a logical operation which states: 
of two elements, either may be zero or one, but 
not both. Thus, whatever is present in the 
accumulator is XORed with itself. Since each bit 
is identical with its exclusive-OR partner, each 
bit will be set to zero. This effectively clears the 
accumulator, readying it for processes to come. 

The final instruction of the group, JP 0674, gets 
out of the way of the Z-80's low memory, for it is 
in this area that the chip's restart codes - very 
frequently used subroutines - are found. Going 
on: 



0674 


D3 


FF 




OUT 


(0FFH) ,A 


0676 


21 


D2 


06 


LD 


HL.06D2H 


0679 


11 


00 


40 


LD 


DE,4000H 


067C 


01 


36 


00 


LD 


BC.0036H 


067F 


ED 


B0 




LDIR 




0681 


3D 






DEC 


A 


0682 


3D 






DEC 


A 


0683 


20 


F1 




JR 


NZ.0676H 



After the jump to 0674, the routine resets the 
output flip-flop at port FF (255 decimal). This 
flip-flop controls both cassette functions and the 
32/64 character video, and by outputting the 
value in A (0, since it was exclusive-ORed 
earlier), the cassette will be off, no data will be 
present at its input, and video will come up 
normally. 

Following this is an interesting (and 
encouraging) piece of code. Using the Z-80's 
powerful block move command LDIR, 54 bytes 
stored at address 06D2 are transferred to the 
RAM address area starting at 4000. These are the 
most important pieces of information the 
TRS-80 must have, so the writers of this program 
took great care to assure that this transfer would 
be certain. The LDIR instruction itself takes 
data stored at an address specified by register 
pair HL (in this case, 06D2), and moves a block 
whose length is specified by register pair BC (36 
hex, or 54 decimal), to the location indicated by 
register pair DE (4000). 

The interesting part is found just below. The 
value in A (0) is decremented twice (to FE), and 
the identical transfer instruction is repeated. 
This goes on until it reaches zero again, a total of 
128 times! We may draw the conclusion that the 
Z-80 chip probably reaches full power and begins 
operating before memory gets to the point where 
it can reliably accept data . . . therefore, the 
instruction is repeated for a period of 
approximately 15 milliseconds. 

Now a portion of RAM is cleared to zero with 
the following few commands: 



0685 


06 27 


LD 


B.27H 


0687 


12 


LD 


[DEI ,A 


0686 


13 


INC 


DE 


068S 


10 FC 


DJNZ 


0687H 
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Recall that after the previous setup process, 
the accumulator again contains zero. Here a 
block of RAM specified by the DE register 
(essentially where we left off) is loaded with zero. 
Using the fast DJNZ (decrement B, branch if not 
zero) instruction, 39 bytes are fixed at zero. 

A few instructions follow that are very 
significant at power-up. Address 3840 contains 
the keyboard row where the BREAK key sits. It 
is connected to data line 4; thus the instruction 
AND 04 checks to see if it is held down. If it is not 
being held down, the result of the AND 
instruction will not be zero . . . and a jump to 
address 0075 will be made. This is why expansion 
interface owners without disks must press the 
break key at power-up: 



068B 


3A 


40 


38 


06BE 


E6 


D4 




0690 


C2 


75 


00 



L0 


A, 13B4DH] 


AND 


04 


JP 


NZ.0075H 



How does the TRS-80 find out that a disk drive 
is in fact connected to the interface? The answer 
to that - and the reason that the computer 'hangs 
up' when an expansion interface is connected 
without a disk - is found in the next few bytes of 
code: 



0693 


31 7D 40 


LD 


SP.407DH 


0696 


3A EC 37 


LD 


A,(37ECH) 


0699 


3C 


INC 


A 


069A 


FE 02 


CP 


02 


069C 


DA 75 00 


JP 


C.0075H 



The stack pointer is set at 407D for use by 
potential future programs; it is out of the way of 
all the BASIC pointers set up in the first data 
transfer, an obvious but important action. 

The accumulator is then loaded with the 
contents of memory location 37EC. There is no 
'memory' per se at address 37EC; it is instead an 
instance of 'memory mapping'. That is, when 
this memory cell is read, a signal is sent to the 
expansion interface. This signal strobes 
information from the Floppy Disk Controller 
(FDC) to the TRS-80. What will it find? 

If no expansion interface is connected, there is 

no signal to strobe. Hence, the value will be 
floating, not pulled to ground (zero) on any bit. 
The computer sees all bits apparently 'high' at 
this location, and interprets it as binary 1111 
1111, that is, hex FF. 

The next instruction increments the 
accumulator, in this case resulting in FF plus 1, or 
00. In the following intruction this value is 
compared to 2. A compare (in effect a 
subtraction, with no 'result') will cause the carry 
flag to be set, since minus 2 is negative. (Note: 



Why compare with 02? Why not just 01 , as a carry 
would still be generated? My suspicion is that it 
is possible for those data lines to 'float' in the low 
state. In that case the CPU would 'see' 0000 0000, 
with the INC A instruction resulting in a value of 
01 - which is still incorrect. So a compare with 02 
guarantees the presence or absence of the disk 
controller.) 

Once the carry flag has been set, the 
instruction JP C,0075 would be executed, sending 
the program to address 0075. For the moment, 
however, let's assume that an expansion 
interface is connected to the TRS-80. 

The FDC, when queried by the command LD 
A,(37ECH), will respond with 80. Incremented by 
one it becomes 81, and comparing it with 02 
generates no carry. The JP C,0075H is thus 
ignored, and the program simply goes on to find: 



069F 


3E 


01 




06A1 


32 


E1 


37 


06A4 


21 


EC 


37 


06A7 


11 


EF 


37 


06AA 


36 


03 





LD 


A.1 


LD 


(37E1H) ,A 


LD 


HL.37ECH 


LD 


DE.37EFH 


LD 


IHL) ,3 



The accumulator is set to 1, and address 37E1 
is made to accept the contents of the 
accumulator. Again, 37E1 is a location memory 
mapped in the expansion interface. This code 
starts the disk drives rotating (or keeps them 
rotating), and selects drive zero. 

That done, it loads HL with the disk controller 
address (37EC) and sends out a 'restore' 
command, which tells the controller to move to 
track zero. Thus, the data will come from drive 
zero and track zero. Register DE is prepared by 
loading it with the disk's data address, 37EF. 
Now: 



06AC 


01 


00 


00 


LD 


BC.OOOO 


06AF 


CD 


60 


00 


CALL 


0060H 


0060 








ORG 


0060H 


0060 


0B 






DEC 


BC 


0061 


78 






LD 


A,B 


0062 


B1 






OR 


C 


0063 


20 


FB 




J P. 


NZ.0Q60H 


0065 


CS 






RET 





This is a short but very useful subroutine. You 
may in fact want to call this yourself from time to 
time. Found at address 0060 is a simple delay 
loop; load the BC register pair (as is done just 
before the CALL instruction), and it is 
decremented and tested until it reaches zero. 
When it finally reaches zero, a return instruction 
sends the Z-80 back to the main program flow. 

Why a delay? Merely to give the disk drive 
time to come up to speed, obvious but very 
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important. Moving ahead with this branch of the 
program: 



06B2 




ORG 


0BB2H 


06B2 


CB 46 


BIT 


D , (HL) 


Q684 


20 FC 


JR 


NZ.06B2H 



This is a loop which waits until the disk control 
chip says, "Okay, disk is up to speed and 
everything looks pretty good", and sends along a 
zero. The program loop tests this bit until it 
receives a zero. It is this loop which is maddening 
to you expansion interface owners who have no 
disk drive. Like all the previous 
memory-mapped addresses, 37EC will never 
have that zero. If a disk is present and all is well, 
the loop will have found the acknowledging zero 
sent by the FDC: 



D6B6 


AF 






X0H 


A 


D6B7 


32 


EE 


37 


L0 


(37EEH) ,A 


06BA 


01 


00 


42 


LD 


BC.4200H 


06BD 


3E 


BC 




LD 


A.BCH 


06BF 


77 






LD 


(HL) ,A 


06C0 


CB 


4E 




BIT 


1 ,[HL) 


06C2 


2B 


FC 




JR 


NZ.06C0H 


06C4 


1A 






LD 


A, IDE) 


06C5 


02 






LD 


(BC) ,A 


D6C6 


oc 






INC 


C 


06C7 


20 


F7 




JR 


NZ.06C0H 



The accumulator is cleared again, and the BC 
register is set to 4200. This will be an area of 
RAM set aside for disk use. 37EE is loaded with 
0, and 37EC is loaded with byte 8C. This selects 
sector 0, and sets the read condition. Thus, 
having previously been set to drive zero, track 
zero, it will now read sector zero. The 
accumulator will look for the incoming bytes in 
the memory location specified by the DE register 
pair (37EF). This is the memory-mapped 
location through which the actual data will flow. 

The accumulator picks up the data from DE, 
stores it in the RAM memory location indicated 
by BC (4200); the next instruction increments 
register C so that location 4201 is ready. The 
program loops back, waits for another message 
from the FDC, picks up another byte, and stores 
it. When register C finally reaches zero, the 
pointer will again contain 4200, and the loop 
terminates. Then: 



0BC9 



C3 00 42 



JP 



4200H 



Here the disk system takes over completely. 
As you recall, starting at 4200, data from the disk 
has been stored. By jumping to that location, the 
program direction is wrested from ROM and 
given to the first 256 bytes of the disk system 
bootstrap program. 

Here, then, is a quick review of the activity so 
far: Interrupts are disabled, cassette is turned off 



and data are cleared from that output, video is 
restored to normal, and significant pointers for 
BASIC program operation are set up. A disk 
drive is searched for and if one is found, a group 
of procedures is initiated in order to transfer 
control of the TRS-80 to these disk instructions. 

A series of control signals and 
acknowledgments is exchanged between the 
floppy disk controller and the CPU, a page (256 
bytes) of data is poured into a RAM buffer area, 
and program control is given over to this new 
series of commands. 

If a disk drive is not found, or if the break key 
is held down during power-up, control is 
transferred to address 0075. At this point it 
should be noted that the 'reset' button on the 
TRS-80 is a non-maskable interrupt, that is, the 
only interrupt which the DI (Disable Interrupt) 
command first executed by the TRS-80 cannot 
mask out. When pressed, the reset button goes 
directly to address 0066, following a much shorter 
series of instructions reminiscent of the 
power-up routine. ' 

Because it is likely most important RAM 
pointers are still intact, this sequence does not 
reset them: 



00B6 








0R6 


0066H 


0066 


31 


00 


06 


LD 


SP,0600H 


0069 


3A 


EC 


37 


LD 


A, (37ECH) 


006C 


3C 






INC 


A 


0060 


FE 


D2 




CP 


02 


006F 


D2 


00 


00 


JP 


NC.0000 


0072 


C2 


CC 


06 


JP 


D6CCH 



This group of instructions sets up the stack 
pointer, checks for the presence of a disk drive, 
and jumps to the complete initialization routine 
(reboot) if it finds one. If none is present, it goes 
to the READY sequence beginning at address 
06CC. 

Now let us return to the initialization program 
flow we have been following, which is found at 
0075: 



0075 








ORG 


0075H 


0075 


11 


B0 


40 


LD 


DE.4080H 


0078 


21 


F7 


IB 


LD 


HL.18F7H 


007B 


D1 


27 


00 


LD 


BC.0027H 


D07E 


LD 


BO 




LDIR 





Using the LDIR instruction described earlier, 
a block of information located at 18F7 is 
transferred to RAM beginning at 4080. These 
bytes describe ports in use, error storage, 
INKEY$ information, and so forth, as needed in 
the general operation of Level II BASIC (see 
Chapter 2). 
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A few specific addresses are delineated, and a 
large group of RAM bytes is then prepared. 
These jump to the familiar '?L3 ERROR' 
message because they are disk commands not 
available to Level II, yet patch points are 
prepared for them. The result of the following 
program statements is to fill addresses 4152 to 
41A5 with the direction JP 01 2D. 



QD8E 


11 


2D 


01 


0091 


06 


1C 




0093 


21 


52 


41 


0096 


36 


C3 




0098 


23 






0099 


73 






009A 


23 






009B 


72 






009C 


23 






009D 


1D 


F7 





LU 


DE.012DH 


LD 


B.1CH 


LD 


HL.41 52H 


LD 


!HL) ,0C3H 


INC 


HL 


LD 


(HL) ,E 


INC 


HL 


LD 


(HL) ,D 


INC 


HL 


DJNZ 


009EH 



Another group of ROM 'breakout' points 
follows; they all become returns to the main 
program flow. But notice something interesting 
about them - three bytes are set aside, but only 
one is filled with the return instruction (C9). 
This means that a jump command could be 
placed there. Let's first look at the series of 
instructions, then examine the possible benefits 
of changing them: 



009F 


06 


15 


00A1 


36 


C9 


00A3 


23 




00A4 


23 




OOAS 


23 




00A6 


1 


F9 



LD 


B.15H 


LD 


[HL] ,0C9H 


INC 


HL 


INC 


HL 


INC 


HL 


DJNZ 


00A1H 



If we wanted to break into the BASIC 
operating system, this area of RAM is one place 
in which we could do it. Most of these are error 
codes of one kind or another. We could 'rescue' a 
program from displaying an error message, and 
halting, by patching in one of our own routines. 
If our routine were located at 5000, for example, 
the C9 instruction (followed by two unused 
bytes) could be replaced with a JP 5000 
command, which needs all three byte positions: 
C3 00 50. Essentially, the authors of Level II 
BASIC provided many areas for expansion. 

Now let's move on. BASIC programs begin at 
address 42E9. A pointer to that beginning is 
found as a zero at address 42E8. The next 
instruction sets that in place: 



00A8 
00AB 



21 EB 42 
70 



LD 
LD 



HL.42E8H 
[HL] ,B 



The stack pointer is delineated, and a call is 
made to 1B8F, a subroutine to turn off or reset 
various devices, including the printer and 
cassette player. It is in part redundant, but a 
double-check is often worthwhile. 



00AC 


31 


F8 


41 


LD 


SP.41FBH 


O0AF 


CD 


BF 


1 B 


CALL 


1BBFH 


00B2 


CD 


C9 


01 


CALL 


01C9H 



The call to 01C9 results in the screen being 
cleared and the cursor being placed at position 0. 
Finally, 'MEMORY SIZE?' appears: 



00B5 


21 


05 


01 


Q0B8 


CD 


A7 


28 


00BB 


CD 


B3 


1B 



LD HL.010SH 

CALL 28A7H 

CALL 1BB3H 



At address 0105 is a block of ASCII bytes which 
spell out MEMORY SIZE. The subroutine 
starting at 28A7 displays the string of data at the 
present location of the cursor, a byte at a time, 
until it finds a byte in the message whose value is 
00. This terminates the display and advances the 
cursor. The call to 1BB3 is identical to the 
BASIC INPUT command, in that it displays the 
question mark and cursor, and halts for keyboard 
input. 

If the keyboard input is the BREAK key, a 
carry is generated, and the program skips back to 
MEMORY SIZE and displays it again, waiting 
for keyboard input. The instruction RST 10 
(ReSTart at 0010) follows, which is the quickest 
way of calling a routine to locate the first 
character of an input. If one is found, the result 
of an OR instruction will not be zero. Here are 
the instructions that perform those functions: 



00BE 
00C0 
00C1 
00C2 



38 F5 

D7 

B7 

20 12 



Jfl 


C.00B5H 


RST 


10H 


OR 


A 


JH 


NZ.00DEH 



What if, on the other hand, there was no entry 
other than the ENTER key? You have no doubt 
noticed a slight pause in the action when you do 
not specifically set the memory size. Here's a 
look at that code: 



00C4 
00C7 
00C8 
00C9 
00CA 
OOCC 
00CD 
00CE 
00CF 
00D0 
00D1 
D0D2 
00D4 



21 4C 43 
23 

7C 

B5 

28 1B 

7E 

47 

2F 

77 

BE 

70 

2B F3 

18 11 



LD 


HL.434CH 


INC 


HL 


LD 


A,H 


OR 


L 


JR 


Z.00E7H 


LD 


A,[HL) 


LD 


B,A 


CPL 




LD 


[HL] ,A 


CP 


(HL) 


LD 


[HL] ,B 


JR 


Z.00C7H 


JR 


00E7H 



For the moment we will start at the instruction 
LD A,(HL). HL contains the address of a byte of 
RAM memory, the contents of which are placed 
in the accumulator. From the accumulator, they 
are also saved in the B register. The accumulator 
is complemented, which inverts all the ones to 
zeros and all the zeros to ones. This 
complemented value is then placed in the 
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memory location still specified by HL. The 
accumulator is compared with what has been 
placed in HL. 

What, you ask? But this value was just placed 
in memory, why compare it? Because - and this is 
a very elegant piece of writing - if it does not 
compare: 

1. The memory location is bad and only the 
block of memory below it should be used to 
be safe. 

2. Or, this is the end of memory. 

If this is good memory, then, the test for zero 
passes, the contents saved in register B are 
returned to memory, and the program loops 
back, incrementing HL to the next potential 
memory location. 

We did skip a few instructions back there. 
They become important only after the first loop 
is complete. These commands OR the contents 
of H and L; when the result is zero, we are at 
address 0000 - full 48k memory has been found, 
and the test is complete. 

Here's what we would find, alternatively, if we 
entered some value (or other characters) in 
response to MEMORY SIZE?: 



0006 


CD 


5A 


1E 


00D9 


B7 






000A 


C2 


97 


19 


0000 


EB 






00DE 


2B 






00DF 


3E 


BF 




00E1 


46 






00E2 


77 






00E3 


BE 






00E4 


70 






00E5 


20 


CE 





CALL 


1E5AH 


OR 


A 


JP 


NZ.1997H 


EX 


DE.HL 


DEC 


HL 


LD 


A.BFH 


LD 


B, (HL) 


LD 


(HL) ,A 


CP 


(HL) 


LD 


(HL) ,B 


JR 


NZ.00B5H 



The call to 1E5A checks for numeric input, and 
jumps to 1997 ('?SN ERROR'), if it is not 
numeric. If the input is properly numeric, then 
registers DE and HL are exchanged; this action 
puts DE (left off at the lowest usable memory 
location above pre-set RAM needed by BASIC) 
in HL, where it can be manipulated conveniently. 

Memory size minus one is usable; memory size 
and above is protected. So HL is decremented 
before being tested, then it is tested (in a manner 
similar, but not identical, to that done earlier). If 
the memory test fails, it's back to displaying 
MEMORY SIZE? again. 

We're not quite there yet, however, as the 
figure entered for memory size may be too small. 
BASIC needs a bit of room to work with, so DE is 
set to 4414, and the subtraction subroutine at 
RST 18 is called. If a carry is generated, we're 
shipped off to the '?OM ERROR' message found 
at 197A. Here's what it all looks like: 



00E7 


2B 




DEC 


HL 


00E8 


11 


14 44 


LD 


DE.4414H 


00EB 


DF 




RST 


18H 


00EC 


DA 


7A 19 


JP 


C.1B7AH 



A little more work is left to do. Recall that a 
value for available string space is set aside, and it 
is 50 bytes. Here is how it is done: 



00EF 


11 


CE 


FF 


LD 


DE.OFFCEH 


OOFS 


22 


B1 


40 


LD 


I40B1H) ,HL 


00F5 


19 






ADD 


HL.OE 


00F6 


22 


A0 


40 


LD 


(40A0H) ,HL 



Register pair DE is set up with FFCE, which, if 
you are not yet weary of manipulation of hex 
numbers, is the two's complement of 50 decimal. 
That is, when FFCE is added to 0000, the result is 
FFCE hex, or 50 decimal less than the original 
figure. Try it to see that it works. This bit of code 
saves the value for top of available memory in 
40B1, adds register DE to it, and saves that result 
(memory size minus 50 bytes for string space) in 
address 40A0. 



There follows: 



DDF9 



CD 4D 1B 



CALL 



1B4DH 



Here let me quote Roger Fuller, whose TRS-80 
Supermap identifies this subroutine this way: 
Revelation 21:5 -"And behold. . . He shall make 
all things new." 

This subroutine identifies and sets up all 
pointers necessary for the start of a BASIC 
program: Variables reset, previous program 
deleted, etc. 

And now, the moment you've all been waiting 
for. Here it is: 



00FC 


21 


11 


01 


0OFF 


CD 


A7 


2B 


0102 


C3 


19 


1A 



LD 

CALL 

JP 



HL.0111H 

28A7H 

1A19H 



The call to 28A7, you may recall, displays a 
string of ASCII characters. The string displayed 
in this case is . . . 

RADIO SHACK LEVEL II BASIC 

The final instruction is a jump to 1A19, the 
address of the 'READY' display. 

To summarize this last portion of the 
initialization routine: all BASIC pointers, disk 
error codes, and ROM return codes are set up, 
the screen is cleared, and the MEMORY SIZE 
prompt is displayed. A valid response to that 
question is accepted, and, if necessary, the entire 
bank of memory is tested. Error messages are 
generated as needed. Finally, the memory size 
and available room for strings is recorded, the 
READY prompt is displayed, and control of the 
TRS-80 is given to the user. 
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Copacetic Comprehension 

There will doubtless be a day when books like 
this will be unnecessary. Personal computers will 
probably develop into the appliance area, with 
programmers, hobbyists, hardware designers 
and language specialists present only in the 
distant background of the market. But between 
now and then we are all faced with being either 
frustated users or solderer-programmers, 
tailoring machines according to our personal 
demands. 

To do this, certain skills are inevitably 
required. Among these are an understanding of 
non-decimal number systems, digital logic 
devices, machine-level languages, and a 
smattering of diagnostic sense. There are some 
fine books that cover all these topics (see 
Appendix II), so this chapter will only deal with 

them as far as needed to put this book to work. 

Among them are: 

• Binary, decimal and hexadecimal 
number systems, how they arose, how and 
why they can be used, and where 
understanding them is essential. 

• Common digital logic devices that 
appear in the TRS-80 and these projects, 
and how and where to use them. 

• Some of the basic elements of machine 
language, and a few personal considerations 
on where it is best applied, and when BASIC 
is a better choice. 



• A look inside the TRS-80, with an eye to 
diagnosing where troubles might lie and 
where changes might be in order. 

• The basics of creating a workable power 
supply for the projects in this book. 



Number Systems 

Numbering is the single most overrated 
problem in computer programming. The answer 
(posed before the question) is this: numbers are 
merely counting names. That is, it makes no 
difference whether we think in tenths of a mile or 
eighths of an inch. Nor does it bother us that a 
day is made up of 24 hours, while an hour is 60 
minutes. That a year is 365 days frightens us not, 
nor that months are a motley collection of sizes. 

In parking lots, does it bother us that our 
vehicle may be parked in Row N as opposed to 
Row 14? There is no mystery when we mark off 
points with four scratches and a Crosshatch. And 
does a dozen always conjure up 'twelve', or is a 
dozen something we have understood since 
youth? 

Names are sizes are numbers; so it is with the 
number systems that we arbitrarily assign for the 
convenience of working with computers. When 
we are talking about electrical signals, it is 
clearest and easiest to think about ons and offs. 
Ons look pretty much like ones, and offs look like 
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zeros. It's a nice, clean concept, and one that 
illuminates the way we can refer to the 
machinery. 

There's more convenience to naming a 
computer data condition 10110100 than to 
calling it an on off on on off on off off. Were data 
the only consideration, the binary one and zero 
method might have been satisfactory, without 
resorting to other means or stroking our 
memories. 

Finding a location in a computer's memory is a 
much more difficult task. Although a memory 
location called . . . 

11101000100110101 

. . . might be easier to think about than . . . 

onononoffonoffoffoffonoffoffononoffonoffon 



... it could use another step forward. In 
music, a long string of sixteenth notes like this - 




Figure 2-1. Illustration of illegible musical notation. 

- is broken up to make it legible, so it looks 
instead like this - 




Figure 2-2. Illustration of legible musical notation. 



Likewise, that long binary string can be broken 
up from 1101000100110101 into convenient 
groups . . . 



Converting Binary to Decimal 

In the grade school years, students used to 
learn that a number like 5,163 contained a 3 in 
the ones place, a 6 in the tens place, a 1 in the 
hundreds place, and a 5 in the thousands place. 
It was to remind them that 5,163 was really 3 
plus 60 (6 x 10) plus 100 (1 x 10 x 10) plus 5,000 
(5 x 10 x 10 x 10). 

The way other number systems are written 
follows this same pattern for their own bases. 
In base eight the number 5,163 would have a 3 
in the ones place, a 6 in the eights place, a 1 in 
the sixty-fours place, and a 5 in the 
five-hundred-twelves place. That means that 
5,163 is really 3 plus 48 (6 x 8) plus 64 (1 x 8 x 
8) plus 2,560 (5x8x8x8). But notice how 
that's decimal thinking! Really in base eight 
there could be no '8' . . . it would have to be 
called '10'! 1, 2, 3, 4, 5, 6, 7, 10, 11, 12, 13, 14, 
15, 16, 17, 20, and so on. So 5,163 in base eight 
is still 3 plus 60 plus 100 plus 5,000! 

The binary system sneaks in the same way. 
A number like 1101 0001 0001 0011 turns into a 
1 in the ones place, a 1 in the twos place, a in 
the fours place, a in the eights place, all the 
way up to a 1 in the 

thirty-two-thousand-seven-hundred-sixty-sevens 
place. In binary, the one on the far left is still a 
1 in the quadrillions place, don't forget. But 
the message is how to convert all this to 
decimal. And here it is: 

3276B 16384 8192 4096 2048 1024 512 256 128 64 32 16 B 4 2 1 
1 1 1010010011 



Just add the numbers: lxl + 1x2 + 0x4 + 0x8 
+ 1x16 . . . + 1 times 32,768 = 41,619. Voila. 
No matter how long the number is, and in 
whatever base: 

1. Start at the left and produce a chart of 
the base number's powers, starting with 
(X to the power is always 1). 

2. Lay the number to be converted 
underneath the base number chart. 

3. Multiply each base number power by the 
digit in its place. 

4. Sum the resulting numbers. 

Does it work? Certainly. What is 163,341 in 
base 9? And in base 7? And in base 10? 



Base 9 powers : 


5 4 3 


2 


1 


D 


9 to that power: 


59049 6561 729 


61 


9 


1 


Number to convert 


1 6 3 


3 


4 


1 


Multiplication: 


1x59049 6x6561 3x729 


3x81 


4x9 


1x1 


Subtotals: 


59049 +39366 +2187 


+243 


+36 


+1 


Converted result: 


100882, base 10 






Base 7 powers: 


5 4 3 


2 


1 


D 


7 to that power: 


16807 2401 343 


43 


7 


1 


Number to convert 


1 6 3 


3 


4 


1 


Multiplication: 


1x16807 6x2401 3x343 


3x49 


4x7 


1x1 


Subtotals: 


16807 +14406 +1029 


+147 


+28 


+1 


Converted result: 


32416, bese 10 






Base 10 powers: 


5 4 3 


a 


1 





10 to that power: 


100000 10000 1000 


100 


10 


1 


Number to convert 


16 3 


3 


4 


1 


Multi plicetion: 


1x100000 6x10000 3x1000 3x100 4x10 


1x1 


Subtotals: 


100000+60000 +3000 


+300 


+40 


+1 


Converted result: 


163341 , base 10 
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1101000100110101 

. . . although the legibility is improved, the 
human spark, the ability to look and recognize 
(that aha! ) is not there. So the next step is to set 
about naming the sections. Since these on-off 
conditions can be written down as binary 
numbers, why not write them down in their 
decimal eauivalents? 

The question is rhetorical, of course, because 
not only can it be done, it is done. The only 
question is how to do it. Were a computer 
capable of swallowing all sixteen of those binary 
digits (bits) in one gulp, that question might be 
easily answered by calculating the conversion of 
1101 0001 0011 0101 using a binary-to-decimal 
conversion table. The result, we find, is 53557. 



But the computer, alas, cannot swallow all 
those bits in one bite ... it can only swallow one 
byte full of bits (pardon). In other words, though 
a computer may need numbers sixteen bits long, 
only eight data lines exist to carry that data. 

The component parts of the number 
1101000100110101 are needed, eight bits at a 
time: 11010001 00110101. 

There's the mathematical rub. 11010001 is 209 
decimal, and 00110101 is 54 decimal. This seems 
hardly related to 53,557. Another solution is 
necessary, and it is a naming system as much as a 

numbering system. It names each of the sixteen 
possible combinations of four binary digits: 



Reading the Pins 

Finding your way through digital circuits is 
much easier than finding your way through an 
ordinary table radio. Industry standards have 
made the process simple. Consumer integrated 
circuits are packaged in small, rectangular, 
plastic or ceramic cases with anywhere from 8 
to 40 external connections known as pins. 

Earlier integrated circuits - and many of the 
audio types currently being produced - were 
packaged in small metal cans and looked like 
transistors, with many wires protruding from 
the bottom. The wires were arranged around a 
keying tab on the edge of the can, and 
numbered like so: 




Figure 2-3. Can-type IC pin numbering. 

As such circuits developed into more 
sophisticated and powerful devices, more pins 
were needed for input and output. A 
rectangular package was developed, but it was 
still numbered in a circle, starting (when 
looking down from the top) from the left of the 
notch, so: rn m rn m 



All modern integrated circuits can be read 
from the top in this same way. 14- and 16-pin 
types start from the top left and read around: 

r r r r r r r 



LJ Id Ld LI Id Id Ld 

RRRRRRRR 



uuuy 

Figure 2-4. Dip- type IC pin number (8 pins). 



'LdLdLdldldLdLdLd 

Figure 2-5. 14- and 16-pin Dip IC pin numbering. 

You can read the pinouts of 18-, 20-, 24-, 28- 
and 40-pin circuits in the same manner. The 
highest numbered pin sits just opposite the 
lowest numbered pin. In the beginning this 
practice may seem confusing; it is. But after 
using the circuits - and counting their pins over 
and again - you will probably feel comfortable 
with the pin arrangement. 

Just one thing: when you assemble TRS-80 
add-ons, most of your work will be done from 
the bottom . . . which means reading 
backwards! 
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0000 


16 


named 





and 


is 


equaL 


to 


decima L 





0001 


is 


named 


1 


and 


is 


equal 


to 


decimal 


1 


0010 


is 


named 


2 


and 


is 


equal 


to 


decimal 


2 


0011 


is 


named 


3 


and 


i s 


equal 


to 


decimal 


3 


0100 


is 


named 


4 


and 


is 


equaL 


to 


decimal 


4 


0101 


i s 


named 


5 


and 


is 


equaL 


to 


decimal 


5 


0110 


i s 


named 


6 


and 


1 s 


equaL 


to 


decimaL 


6 


0111 


is 


named 


7 


and 


1 s 


equal 


to 


decimel 


7 


1000 


lb 


named 


B 


and 


is 


equal 


to 


decima L 


8 


1001 


is 


named 


9 


and 


is 


equaL 


to 


decimaL 


9 


1010 


is 


named 


A 


and 


is 


equal 


to 


decimal 


10 


1011 


i s 


named 


B 


and 


1 s 


equal 


to 


decimal 


11 


1100 


is 


named 


C 


and 


i s 


equal 


to 


decimal 


12 


1101 


i 5 


named 


D 


and 


16 


equaL 


to 


decimal 


13 


1110 


i s 


named 


E 


and 


is 


equal 


to 


decimal 


14 


1111 


i s 


named 


F 


and 


i s 


equal 


to 


decimal 


15 



This may seem overdone; but A, B, C, D, E, and 
F are darn good names for binary values which 
exceed the number nine. If you don't have a 
name, make one up. For practical purposes, keep 
it within the symbols everyone has on the Royal 
typewriter. 

Back to the number 1101000100110101. Crack 
it into those four legible pieces (1101 0001 0011 
0101), and it can be named D135. To convert it to 
decimal, remember the old rule: the 5 is in the 
ones place, the 3 is this time in the sixteens place, 
the 1 is in the two-hunded-fifty-sixes place, and 
the D is in the four-thousand-ninety-sixes place. 
Thus, D135 is 5 plus 3 x 16 plus 1 x 256 plus (see 
the chart) 13 x 4,096, or . . . 53,557! 

So, that long binary number can actually be 
digested by the computer as a byte of Dl and a 
byte of 35. After a while, the number system 
comes easily. My personal recommendation: 
work in it. Convert to decimal only when you 
absolutely must. Think in hexadecimal and 
binary. They are the tools with which you can 
speak to the computer. 

Throughout this book, numbers in 
hexadecimal are printed in BOLD. 

Digital Logic Devices 



Back to digital logic devices. The essence of 
digital logic is to evaluate binary, on-off input; 
sometimes to determine a pattern of similarity or 
difference, sometimes to sense a change and 
sometimes to search for a signal. An appropriate 
result is produced as a result of the logical 
operation. 

One of the logic building blocks is called a gate. 
A gate electronically evaluates its input to 
determine the pattern of similarity and 
difference of signals, and produces a specific 
output. A simple gate is shown below: 




Figure 2-6. Simple AND gate. 

Its job is to determine if the first AND second 
inputs are both at the one (high) level. Only 
under that condition will its output produce a 
high (one) signal. The table below shows how 
this AND gate works. 



If input #1 1s 



AND Gate 
If Input #2 is 





1 o 

1 

1 1 

Table 2-1. AND gate action. 



The output result 1s 






1 



The table is called a truth table, and its 
purpose is to present every possible input and 
output condition for a given gate. Below is an OR 
gate. Stated in words, if either the first OR the 
second input is high, the output will be high. 
Examine the OR gate truth table; it really is quite 
logical. 



The binary number system and digital logic 
devices were developed together as a way of 
solving a practical dilemma: how to mass produce 
computers which could work quickly and 

accurately, and yet be inexpensive. As noted in 
Chapter 1, the problems of creating consistently 
accurate circuits, working with many different 
voltages levels, are formidable. Thus, simple 
yes-no, on-off logic was developed. 

The intimidating term Boolean algebra is 
being used for the first, and last, time in this book 
- right in this sentence. You'll probably hear the 
phrase from time to time, but no matter - it's a 
professional's buzzword to keep the masses out. 
Forget it. 



O 



Figure 2-7. Simple OR gate. 



OR Gate 
Input 1 Input 2 


Output 




1 

1 

1 1 




1 
1 
1 



Table 2-2. OR gate action. 

Given a huge set of interconnected gates and 
their known inputs, the final output of the group 
can be determined by using truth tables like 
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these. Gates may have more inputs than two 
(some have sixteen), and may produce the 
opposite results from the two described above 
(NOT-AND and NOT-OR gates, known as 
NAND and NOR gates). Truth tables reveal how 
the integrated circuit's design engineer specified 
the pattern of binary logic inside the circuit. 

In this way, given a desired output and a 
known number of input signals, it is possible to 
determine what set of input values will trigger 
the desired output. 

There are a number of other types of digital 
circuits. Most are created out of gates like those 
described above, but their features are unique 
enough to think about them separately. Among 
these other digital logic circuits are buffers, 
flip-flops, counters, latches, multiplexers and 
shift registers. 

A buffer can be thought of as a two-input gate 
with both inputs tied together, like this: 




Figure 2-8. Buffer as (a) two-input gate and (b) buffer. 

Its truth table is much simpler than that for 
two-input gates, because there are now only two 
input conditions. Either both inputs are high, or 
both inputs are low. Gates with 'true' outputs 
(AND, OR) will merely follow the input 
condition. When the inputs are high, the output 
is high; if the inputs go low, the output becomes 
low. Separate logic devices are manufactured 
that perform this 'follow-the-leader' function, 
and they are called buffers. They serve to isolate 
sections of a circuit, or rejuvenate a signal so it 
can feed many dozens of inputs in a large 
machine. 

When a buffer reverses the condition of its 
input, (a high input is output low, and vice versa), 
the device is called an inverter. This kind of 
circuit can save the day in some cases, as when 
trying to locate a given binary number. Assume 
a circuit needs the binary number 1 1 10 to turn on 
a pilot light. It is possible to choose four separate 
gates, each of which would provide an output 



matching the desired number. These would be 
connected through more gates, and eventually 
the number could be discovered when the final 
signal was triggered properly. One way of 
detecting 1110 is shown below: 



Figure 2-9. Bad decoding scheme for 1 1 1 0. 

But, although this circuit works, economy of 
cost and space and simple clarity dictate another 
solution. The last input could be inverted before 
it is evaluated, resulting in a pattern (1111) 
which could be quickly recognized by a 
multiple -input gate. The result is electronic 
simplicity and legibility; an improved decoding 
circuit is shown below. The ultimate result is the 
same. 



\>^ 



Figure 2-10. Good decoding scheme for 1 1 1 0. 

A flip-flop is a 'black box' which provides two 
outputs. When an input value is high (one), the 
first output will be high, and the second will be 
low. When the input value switches low (zero), 
the outputs will reverse. In other words, two 
opposite outputs for the price of one. But there is 
another significant use of the flip-flop. 

Flip-flops also have an important input called 
a clock trigger, which is triggered only when its 
input returns to a given level. Only then will the 
outputs of the flip-flop reverse. That is, a given 
flip-flop clock may receive a 'zero' pulse. Its 
outputs will reverse. Then the zero pulse changes 
to a 'one' pulse. Nothing happens, but the trap is 
set to spring. When the one pulse changes back 
to a zero, the outputs reverse again. For every 
two changes at the clock, there will be but one 
change at the output. It takes four clock changes 
to produce two output changes. 
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Why is this useful? Because it is electronic, 
binary division. The truth table here shows how 
it works. 

Binary Division «1th a Flip-Flop 
Output of First FLIp-Flop Connected to Clock of Second 
FUp-Flop6 Change State Each Ti«e Input Returns Low 



Clock 


FUp-Flop 


Second Clock 


Second FUp-Flop 


Input 


Output 



Input 




Output 













1 


D 


a 




D 





1 


1 




C 


1 


1 


1 


















1 


1 










1 





1 


1 




1 


1 


1 


1 




1 


(Input) 


(Input/2) 






(Input/4) 


Table 2-3. 


Binary division with a 


flip-flop. 





Digital logic devices known as counters are 
combinations of gates and flip-flops that allow 
certain patterns to be counted: Binary, Binary 
Coded Decimal (BCD, where the highest number 
is decimal 10), Gray code and others. 

Latches are very much like flip-flops, except 
that the input is 'captured' at the output by a 
trigger signal called an enable, a select, or a 
gating pulse. The input may change 
continuously, but the output only reflects the 
input when the enable is activated. Latches are 
very useful when hundreds of thousands of 
signals are flying around on one set of lines, and 
the computer must select only certain groups of 
signals. The cassette output of data is a latch; 
only the 500-baud (bits per second) pulses of 
data reach the cassette output, even though 
many different signals reach its input. 

Multiplexers are sometimes misunderstood, 
but mostly because of their formidable name. A 
traffic light is a multiplexer - it allows several 
streams of traffic to meet at one intersection, but 
only one stream to proceed. The multiplexer is 
the electronic equivalent, having several inputs. 

Gating signals select which of the inputs may 
reach the output. In a computer, this allows 
several devices to share a circuit (like the video, 
which must be sent to the screen, but also sends 
and receives characters from the rest of the 
computer). 

Finally, shift registers treat bits of data like a 
bucket brigade sends up water: it goes in one end, 
and at each electronic 'go!', the bucket is sent 
along one position. The dots which make up the 
video display are produced by circuits which shift 
them out to the screen one bit at a time, in 
synchronization with the monitor's sweeping 
electron beam. 



Into Machine Language 

If we put faith in etymologists, then 'language' 
- which comes from the Latin meaning whole or 
part of a tongue - is an inappropriate word to put 
after 'machine'. Better to call it code, or blurms, 
or bingo chips even. Whatever it is, it becomes a 
tool for providing the user with all the power 
inside the TRS-80. 

With a knowledge of binary and hexadecimal 
numbers, this language seems more fluid, and 
with a similar understanding of its electronic 
effects, it becomes the true 'lingua franca' of the 
computer. 

In Chapter 1, I pointed out that BASIC is 
really just a disguised form of machine language. 
It is disguised because it presents itself in 
English-looking words, and has a large store of 
safety valves, error traps and messages - to 
prevent it from falling down an electronic rabbit 
hole. 

For the moment I'll turn away from the 
metaphors, and present a practical simulation of 
that statement. The simulation can be familiarly 
written as follows: 

CLS 

When you command CLS (clear screen), 
BASIC enters a machine language subroutine to 
clear the screen. It automatically returns to a 
BASIC command-level 'READY' condition. 
Now I happen to know that CLS is located at 
memory address 01C9 (457 decimal), and that 
(non-disk system) 'READY' is found at 06CC 
(1740 decimal). 

As an experiment, type . . . 
SYSTEM (ENTER) 
/1740 (ENTER) 

. . . and you will be presented with the familiar 
'READY', exactly as if you had pressed the Reset 
button. You've executed a machine-language 
GOTO, jumping directly to the 'READY' routine 
in ROM. As a second experiment, type . . . 

SYSTEM (ENTER) 

/1457 (ENTER) 

Momentarily, the screen clears, but quickly 
crashes to MEMORY SIZE? Why did that 
happen? Notice that I said CLS was a 
subroutine. In other words, the routine must be 
called via some sort of GOSUB. The crash back 
to 'MEMORY SIZE?' occurred because there are 
no error messages in machine language unless 
you create them! 

There are two ways to simulate the required 
GOSUB. The first is to POKE the starting 
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address of the clear-screen subroutine into the 
USR(O) command. The USR(O) command is 
identical to the SYSTEM command, except that 
it is the equivalent of GOSUB, where SYSTEM 
is the equivalent of GOTO. 

So 01C9 (clear screen address) is the USR 
entry point; it must be split in two pieces (01 and 
C9), converted to decimal (1 and 201), and 
POKEd into USR addresses 16,527 and 16,526. 
So . . . 

POKE 16527,1 

POKE 16526,201 

M=USR(0) 

There. A screen clear without crashing to 
'MEMORY SIZE?'. But there is another way. 
The machine language command for GOTO is 
called 'JUMP', and its hexadecimal code is C3. 
The machine language command for GOSUB is 
named 'CALL', and its code is CD. So here is the 
solution: CALL 01C9. JUMP 06CC. 

Various hardware has its peculiarities. In the 
Z-80 microprocessor, addresses are always 
specified in reverse order. So CALL 01C3 is 
written CD (CALL) C9 (least significant byte of 
address) 01 (most significant byte of address). 
And JUMP 06CC is written C3 CC 06. 

The whole process to clear the screen and jump 
to 'READY' is coded: 

CD C9 01 C3 CC 06 

Quite simple. CLS equals GOSUB 01C9, 
GOTO 06CC, which equals CALL 01C9, JUMP 
06CC, which equals CD C9 01 C3 CC 06. The 

nice part of this little process is that it can be put 
anywhere in memory you like. Let's put it 
arbitrarily at 5000 to 5005 (20480 to 20485 
decimal). 



POKE 20480,205 
POKE 20482,1 



POKE 20481,201 



POKE 20483,195 : POKE 20484,204 : 
POKE 20485,6 

Convert the six hexadecimal bytes to decimal 
as shown earlier, and POKE them in place. Now 
you have the program completely under control. 
It is ensconced in memory, it calls the 
clear-screen routine, and jumps to 'READY'. Do 
you believe it? Just try it, entering the program 
at 5000. . . 

SYSTEM (ENTER) 

/20480 (ENTER) 

There. A complete machine language program 
that functions from BASIC command level. 



If you're new to this, take a break. The next 
step is to write an elementary screen-clearing 
routine, instead of calling one already in ROM. 

I want to introduce a dilemma early on in the 
process of learning machine language. There is 
always discussion in computer programming 
about 'reinventing the wheel', and there is much 
truth to the suggestion that one should not do 
programming when the work has already been 
done. In the case of the screen-clearing program, 
the subroutine to do the work has already been 
created, and it is right there in Level II ROM 
waiting to be used. 

Why, then, write another one? Why, in fact, 
even call the routine via machine language when 
the BASIC CLS command works so well? Indeed, 
with a BASIC as powerful as Level II, machine 
language should probably be reserved for doing 
things that cannot be done in BASIC at all. 
Among these things are upper/lower case drivers, 
programs to send characters to a serial printer, 
music-making and sound effects, 
telecommunications and so on. Furthermore, 
where machine language seems required, it often 
makes sense to call as many Level II ROM 
subroutines as possible. 

Slick as this may be, it has two disadvantages: 
much of programming and customizing the 
TRS-80 requires an intense element of learning 
and understanding. Re-inventing the wheel is 
what everyone who learns must do, from the 
child who is forced through the memorization of 
'times-tables', to the adult who has lost a job 
after 25 years and must learn new skills. 

I can only present this from a highly personal 
point of view, as one who could not have learned 
machine language with any fluidity had I 
depended upon the software black boxes of 
others. I suggest that if you want a program to 
perform a certain action, try to write it in 
machine language. Try to make it do the same 
sort of error-trapping and other housekeeping 
that Level IPs subroutines do. Take the Level II 
code apart and have a look. But don't deny 
yourself the opportunity to learn, rather than run 
a personal software assembly line. End of 
sermon. Back to clearing the screen. 

The Z-80 microprocessor has internal holding 
latches called registers. Some are capable of 
holding eight bits, others sixteen. Some eight-bit 
registers may be paired up with others to create a 
single sixteen-bit register. These might be 
thought of as your only Z-80 machine code 
variables. In this screen-clearing routine, several 
registers will be used. The registers to be used in 
this experiment are: B, paired with C; H, paired 
with L; and A. 
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The last of these is the accumulator, a 
sophisticated register capable of doing simple 
arithmetic. Indirectly, the 'condition code' 
register (called the 'flags') will also be needed, 
and will be described when it is used. 

First, the program in its entirety: 



21 00 3C 


START— 


— LD 


HL.3CDDH 


01 00 04 




LD 


BC.0400H 


36 SO 






(HLJ.20H 






23 




INC 


HL 


0D 




DEC 


BC 






LD 


A,B 






OR 


C 


C3 XX XX 




JP 


NZ.LOOP 



Listing 2-1. Simple CLS demonstration. 

In the first line, the H and L register pair is 
prepared with the values 3C and 00. As a pair, 
they are capable, then, of pointing to memory 
position 3C00. This is the memory location of the 
first position at the top left of the video display. 
The next line prepares the B and C registers with 
04 and 00. Although they are pointing to memory 
location 0400, they are going to be used as a 
counter in this program, 400 is 1024 decimal, the 
number of places on the screen. 

In the next line, the parentheses around HL 
mean 'the memory location defined by'. That is, 
the command is saying 'store the value 20 in the 
memory contents defined by the H and L register 
pair' - in this case, 3C00. So LD (HL),20 stores a 
blank space (20 is the ASCII value for such a 
space) at the first place on the screen. Whatever 



was on the screen before is turned into a space. 

Notice that this has the name 'LOOP' next to 
it. This 'label' is for the programmer's eyes, not 
for the program's use. In the next two lines, the 
HL pair is incremented. That is, 3C00 is 
incremented to 3C01. Correspondingly, the BC 
pair is decremented, from 0400 to 03FF. You 
may see the pattern emerging - BC is being used 
in a kind of machine language FOR-NEXT loop. 

In BASIC, a FOR-NEXT loop is sort of 
self-testing. The programmer doesn't have to 
put in anything that checks the value of the loop 
variable; BASIC does it automatically. But in 
machine language, a test has to be made. The 
next two lines of the program make that test. 
The accumulator is prepared not with an 
absolute numerical value, but rather with 
whatever the B register reads at the moment. 
After one pass through, it will be 03. 

Then the accumulator is asked to make a 
logical judgment. Recall that earlier in this 
Chapter, logical OR gates were discussed. If 
either of two inputs were high (one), the output 
would be high (one). In this case, there are eight 
inputs, one for each bit in the byte. So the 
accumulator has been loaded with 03, thus . . . 

00000011 

. . . and it is being asked for the logical OR 

with whatever register C is now set to. In the first 
loop, that is FF - 

11111111 



What's in the Memory Map 

The memory map of the TRS-80 has been 
designed for convenient, immediate use. It 
consists of seven major sections: 

1. The BASIC language in 
read-only-memory (ROM). 

2. An unassigned blank area for future 
expansion. 

3. Special locations for cassette and disk. 

4. A keyboard matrix, appearing in four 
locations. 

5. A video memory. 

6. A reserved block of RAM for BASIC use. 

7. User-programmable RAM for programs, 
data, and variables. 

The onboard jumper, X3, selects which of the 
various language possibilities is active in the 
TRS-80 (see section on electronic organization 



below). Level I BASIC uses only 4,096 bytes from 
address 0000 to 0FFF, but Level II uses from 0000 
to 2FFF. Because of hardware shortcuts, the 
cassette, disk and keyboard locations are 
incompletely decoded, appearing in 'phantom' 
areas beyond those strictly assigned to them. 
Using incompletely decoded locations in the 
cassette/disk area can result in unexpected 
results. But the phantom keyboards can be used 
interchangeably with the actual keyboard 
address. 

The possible memory configurations of the 
TRS-80 Model I, together with reserved RAM 
areas, are shown below. 



Figure 2-39. TRS-80 memory map in detail 
Address Function 



RAM Pointer 



0000 
0000 
0FFF 
2FFF 
3000 
3700 
370E 



Beginning of 111 ROMs 

Power-Up Position 

End of LeveL I ROM 

End of LeveL II ROM 

Beginning of unassigned area 

End of unessigned area 

Disc Status Address 
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37 DF 

37 EO 

37 E1 

37 E4 

37EB 

37 EC 

3800 - 

38FF 

3900 

3A00 

3 BO" 

3C0L - 

3FFF 

4000 - 

4000 

4003 

4006 

4009 

400C 

40 DF 

4012 

4015 - 

4015 

4016 

1018 

401B 

401D - 

4010 

401E 

40 20 

4022 

4023 

4025 - 

4025 

4026 

40 2B 

4029 

40 2A 

40 2B 

4020 - 

4020 ■ 

4035 

4036 ■ 

403C 

403 D 

403 E 

4040 • 

4047 

4048 

407F 

4080 

408D 

408E 

4090 

4093 

4094 

4096 

4097 

4099 

40 9A 

4098 

409C 

4090 

409E 

409F 



Disc Data Address 

Interrupt Flip-flop 
Disc Drive Select 
Cassette Select 
Line Printer Date 
Disc Controller Chip 

Beginning of Keyboard • 

End of Keyboard 
Phantom Keyboerd 
Phantom Keyboard 
Phantom Keyboard 

Beginning of Video 

End of Video 

Beginning Reserved RAM 

Restart #0 Patch [RST B) 
Re6tart #1 Patch IRST 10) 
Restart #2 Patch IRST 18) 
Reetart #3 Patch [RST 20) 
Restart #4 Patch IRST 28) 
Restart #5 Patch (RST 30) 
Restart #6 Petch (RST 38) 

Keyboerd Control Block 

Keyboard Device Type (01) 
Driver Entry Address (2 bytes) 
Three Reserved Bytes 
Two Bytes Reading "KI" 

Video Control Block 

Video Device Type (07) 

Oriver Entry Address (2 bytes) 

Location of Cursor (2 bytes] 

Cursor Charecter 

Too Bytes Reeding "DO" 

Line Printer Control Block 

Printer Device Type (06) 
Driver Entry Address (2 bytes] 
Total Lines Per Page 

Current Line Being Printed 
Reserved Byte 

Two Bytes Reeding "PR" 

■ Level II Workspace 

■ Unessigned RAM 

End Unaasigned RAM 

■ Baginning Keystroke Storage 

End Keystroke Storage 

Video Size / Cassette Latch 
Reserved for DOS Use (2 bytes) 

- Storage Area for TIMES 

End of TIMES Storage Area 

- Reserved for DOS Use 

End of DOS Reserved Area 

- Storege Area for Division 

End of Division Storage Area 
USR Entry Point (2 bytes) 

RND Storage Area (3 bytes) 

IMP Storege Ares 

INPut Port Number (2 bytes) 

OUTput Storage Area 

OUTput Port Number (2 bytes) 

INKEYS Storege Area 

ERROR Code Storege 

Line Printer Position 

Output Device Indicetor 

Video Line Length (32 or 64) 

Video TAB area 

Reserved 



40AO 


•1 




40A2 






40A4 


*2 




40A6 






40A7 


•3 




40A9 






40 AA 






40AD 






40AE 






40AF 






40 BD 






40 B1 


•A 




40 B3 






40 B5 






40 D3 






40 D4 






40 D6 






40 D8 






40 DA 






40 DC 






40 DE 






40 DF 






40 E1 






40 E2 






40 E4 






40 E6 






40 EB 


*5 




40 EA 






40 EC 






WEE 






40F0 






40F2 






40F5 






40F7 






40F9 


*6 




40FB 


»7 




40FD 


•a 




40FF 






4101 






41 1B 






411C 






4130 












41 A4 












41 E7 












4288 






42E8 








































































4FFF 






7FFF 






BFFF 






FFFF 







String Spece Pointer [2 bytes) 

Current Line in Use [2 bytes) 

Start of BASIC Program 12 bytas) 

TAB Position Value 

Input Buffer Pointer (2 bytes) 

Input #-1 Indicator 

Seed Number for RND [3 bytes) 

Reserved 

LFT and DIM Scratchpad 

Number TypB Flag 

"Flag Byte for Encoder" 

Top of BASIC Memory (2 bytes) 

String Scratchped Pointer 

String Workspece (30 bytes) 

Length of String in Use 

Address of String in Use [2 bytes) 

Next Available String Space (2 bytes) 

State of Print Using [2 bytes) 

Current DATA Line in Use (2 bytes) 

DIM Scratchpad (2 bytes] 

Print Using Scratchpad 

SYSTEM Loading Entry Point (2 bytes) 

AUTO On/Off Indicator 

Current Line in Use (2 bytes] 

Size of AUTO Increment (2 bytes) 

Location of BASIC Command in Uss (2 bytes] 

BASIC Stock Pointer [2 bytes) 

ERROR Line Number for RESUME (2 bytes) 

EDIT Line Number in Use (2 bytes] 

Line Number before RESUME [2 bytes) 

ON ERROR GOTO Line Number [2 bytes) 

Reserved (3 bytes] 

Line Number Completed (see also 40E2) 

CONTINUE Line Number (2 bytes] 

Simple Variables Pointer 

Arrays Pointer 

Free Memory Space [FREIA]) 

Pointer to DATA in Memory 

Variable Type Workspace [27 bytes] 

TRON/TROFF Indicetor 

Arithmetic Workspace (20 bytes] 

Line/Print Using Buffer [33 bytes) 

Disc Patch Points (see Chapter <?> 

End Disc Patch Points 

DOS Linking Petch Points 

End Linking Petch Points 

Keyboerd/Edit Input Buffer 

Z-BO Stack During Running Program 
End Input Buffer 

Beginning of BASIC Program 

End of BASIC Program 

Simple Verieble Storage 

End of Verieble Storege 

Array Storage Aree - 

End of Array Storege 

FrBe Memory Aree 

End of Free Memory Area 

BASIC Stack for NEXT, GOSUB, etc. 

Top of BASIC Stock [works downward] 

String Storage Area 

Top of String Storege [works downward) 

Top of BASIC Memory 

End of 4K RAM 
End of 16K RAM 
End of 32K RAM 
End of 48K RAM 



- each bit in the accumulator is ORed with its 
corresponding bit in register C. If any pair of bits 
is 1, the accumulator's bit will be set to 1. When 
the ORing process is finished, the accumulator 
will contain the results, and the condition code 
register will reflect the meaning of those results. 



Listing 2-2. Complete CLS demonstration. 





00100 




00110 




001 £0 




00130 


5000 


00140 


5000 210D3C 


00150 


5003 01FF03 


00160 


5006 3620 


00170 


500B 23 


00160 


5009 OB 


00190 


500A 78 


00200 


5008 B1 


00210 


5O0C 20F8 


00220 


500E C9 


00230 


06 CC 


00240 


00000 TOTAL 


ERRORS 



M#tt*tttintt<itt*tttnittt**ttttt »mtpt»ttitmn»*nttitti 

SIMPLE CLEAR-SCREEN DEMONSTRATION IN ASSEMBLER FORMAT 



ORG 

LU 

LU 

LU 

INC 

DEC 

LD 

OR 

JR 

RET 

END 



bOOOH 

HL.3C00H 

6C.3FFH 

(HL],20H 

HL 

BC 

A,B 

C 

NZ.LOOP 

06CCH 



BEGIN ROUTINE AT 20400 
VIDEO SCREEN, AT 153B0 
1 ,024 SPACES OM SCREEN 
SPACE (DEC 32) IN PLACE 
READY NEXT SCREEN LOC'N 
DROP SPACES LEFT BY ONE 
GET CURRENT COUNT IN B 
OR WITH COUNT LEFT IN C 
GO BACK IF NOT YET DONE 
BACK TO MAIN ROUTINE 
READY AFTER TAPE LOAD 



On the first pass, the accumulator will end up 
containing 11111111, and the condition code 
register's 'zero' flag will read 'not zero'. The last 
line of the program says 'jump if the result is not 
zero'. It jumps back to the part of the program 
marked LOOP, where it will store a 20 (space) in 
the new value pointed to by HL, increment HL 
again, decrement BC again, and go through the 
logical OR test once more. 

If you carry the process through by hand, you 
will discover that only when B and C are both 
zero will the zero flag confirm a zero result. At 
that point, the program can shake loose from its 
loop. 
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Details of storage areas and their use can be 
found in Microsoft BASIC Decoded, Supermap, 
Inside Level II, and the Level II BASIC 
Reference Manual. 

Setting MEMORY SIZE? 

Because machine language programmers have 
devised many unique ways of storing their 
programs, the purpose of responding to 
'MEMORY SIZE?' has been the cause of some 
confusion. A look at the summary of the full 
memory map may help clarify the reasoning. 

Reserved Msaory [not available) 

BASIC ProflreB Text (fills upward) 

Simple Variables (fill upoerd) 

Array VaMsbles (fill upward) 

•»•••• FREE MEMORY SPACE ••*•»«••• 

BASIC Stack (fills do«n»ard] 

String, Storage (Mile do»n»srd] 

MEMORY SIZE Value [above reserved] 

Table 2-4. Memory map summary. 

This table points out two important facts: 
array variables grow upward into the free 
memory space. The BASIC stack (which stores 
GOSUB return addresses, levels of parentheses, 
FOR-NEXT information, etc.) grows downward 
into the free memory space. 

Simple variables can also bump the array 
variables upward; string storage space is set 
ahead of time with the CLEAR statement. So 
you can see that the free memory area is 

impinged upon from both sides while a program 
is running. Although BASIC might have been 
designed to bump everything upward in memory 
(leaving the top area of memory unmolested), it 
would have resulted in considerably longer 
running time. This is because many changes in 
memory would have to be made when new 
variables, strings, parentheses, GOSUBs, etc., 
were discovered during a program's run. 

If any machine language program is to be used, 
it certainly must be stored out of the way of this 
frantic activity. MEMORY SIZE therefore is 
used as a sacred boundary, above it is 'terra 
incognita' as far as the BASIC program is 
concerned. For example, if MEMORY SIZE in a 
16K machine is set to 20480, the computer acts 
precisely as if it were a 4K machine! 

To make maximum memory available for a 
running BASIC program, this boundary should 
be set only just low enough so that the machine 
language program will fit above it. Most program 
authors will write these programs to fit as high as 
possible in memory, and so you will normally see 
memory sizes (for a 16K machine) above 30000. 

Why in a 16K machine would there be a 
'memory size' of about 30000 and not 16000 or 
so? It's simply that the prompt 'MEMORY 



SIZE?' is a bad question. The memory size value 
is really not a size at all, but the address of a 
memory location above which the BASIC 
program and its variables must not go. 

Why then are there machine language 
programs which do not require memory size to be 
set? That is because clever programmers write 
machine language programs that . . . 

- may be written for Level II BASIC, and 
thus can reside in one of the DOS reserved 
areas (see memory map). 

- may automatically reset the memory size 

value before returning to BASIC. 

- may be packed into strings where they are 
safely protected in a program text line (see 
Chapter 3). 

- may be short enough to reside in part of 
the input buffer and change its pointer. 

In all of these cases, something is sacrificed for 
the convenience of not setting 'MEMORY 
SIZE?'. In the first case, DOS-like expansion 
programs, such as Level III BASIC, will conflict. 
In the second case, programs which also require 
the memory size to be set may be damaged when 
the loading program automatically resets it. 
Thirdly, string-packed lines may not be edited 
without calamitous results. And finally, a 

reduced input buffer makes editing long lines 
impossible, as they will probably run into the 
BASIC program text. 

So the 'MEMORY SIZE?' boundary is a useful 
feature of BASIC, serving to protect machine 
language programs from the expansionist 
tendencies of a running BASIC program. 

Comparing The Levels 

Another source of confusion to a lot of users 
was the switch from Level I to Level II. How did 
this simple change of language alter the 
hardware? How did double-width characters, 
500-baud tape loading, and key rollover suddenly 
appear? Why did the convenient abbreviations 
(P., N., M., F., etc.) suddenly go? Why were 
machine language programs happy with CLOAD 
in Level I, but needed SYSTEM with Level II? 

The 4K BASIC in Level I is a compact, limited 
language with a few capabilities. Level II is three 
times as long, and much more powerful. Their 
authors, and hence their approaches, are 
different. The single hardware change in going 
from Level I to Level II is the installation of one 
ROM set in favor of another, and a minor change 
to allow 12K instead of 4K ROM to be accessed. 
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The 32-character mode hardware was already 
in place. The tape load speed and key rollover are 
all software controlled (see supplement to this 
Chapter). The abbreviations disappeared 
because Level II handled its keywords in a 
different manner from Level I, and such 
abbreviations would have increased execution 
time. Likewise, tape loading formats were a 
matter of design philosophy rather than any 
formal software requirements. 

Level I has the advantage of being a simple, 
easily learned first language for computer 
beginners, and many TRS-80 owners learned by 
using that language. Level III is not a language 
distinct and apart from Level II, but rather an 
extension of the existing one. (In this sense it is 
much like Extended Color BASIC on the new 
TRS Color Computer, which does not supplant 
the original 8K BASIC, but merely adds another 
8K to it). 

What are the differences between the three 
levels? A command list for the three languages, 
with differences highlighted, follows: 

Table 2-5. Comparison of Level I, II and III commands. 



Command 


Level I 


■ 




A. (ABS) 


X 


ABS 


X 


ASC 




AT 


X 


ATN 




C. ICONT) 


X 


CDBL 




CHRS 




CINT 




CL. (CLOAD) 


X 


CLEAR 




CLOAD 


X 


CLOSE 




CLS 


X 


CMO 




CONT 


X 


COS 




CS. ICSAVE) 


X 


CSAVE 


X 


CSNG 




CVD 




CVI 




CVS 




D. [DATA) 


X 


DATA 


X 


DEFDBL 




OEFFN 




DEFINT 




DEFSNG 




DEFUSR 




DEFSTR 




DELETE 




DIM 




E. [END) 


X 


EDIT 




ELSE 




END 


X 


ERL 




ERR 




ERROR 




EXP 




F. IFOR) 


X 


FIELD 




FIX 




FOR 


X 


FRE 




G. (GOTO) 


X 


GET 





Level II 


Level III 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 




X 


X 


X 




X 


X 


X 


X 


X 


X 


X 


X 


X 




X 




X 




X 


X 


X 


X 


X 




X 


X 


X 


X 


X 




X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 




X 


X 


X 


X 


X 


X 


X 



GOS. 1G0SUB) 

GOSU8 

GOTO 

I. [INT) 

IF 

INKEYS 

IN. (INPUT) 

INP 

INPUT 

INSTR 

INT 

KILL 

L. (LIST) 

LEFTS 

LET 

LSET 

LEN 

LINE 

LIST 

LOAD 

LOC 

LOF 

LOG 

LPRINT 

M. (MEM) 

MEM 

MERGE 

MIDt 

MUM 

MKIS 

MKSS 

N. [NEXT, NEW) 

NAME 

NEW 

NEXT 

NOT 

ON 

OPEN 

OUT 

P. [PRINT, POINT) 

P. A. [PRINT AT) 

PEEK 

POINT 

POKE 

POS 

PRINT 

PUT 

R. [RESET, 
RNO.RUN) 

RANDOM 

REA. (READ) 

READ 

REM 

RESET 

REST. (RESTORE) 

RESTORE 

RESUME 

RET. (RETURN) 

RETURN 

RIGHTS 

RND 

RUN 

S. (SET, STEP) 

SAVE 

SET 

SGN 

SIN 

SOP 

ST. (STOP) 

STEP 

STOP 

STRINGS 

STRS 

T. (THEN, TAB) 

TAB 

TAN 

THEN 

TIMES 

TROFF 

TRON 

USING 

VAL 

VARPTR 

> 

< 



/ 
S 
I) 



X 
X 

X 

x 

X 

X 
X 
X 
X 



X 
X 

X 
X 

x 
x 
x 

X 
X 

X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 
X 



X 

X 
X 

X 
X 

X 

X 

X 
X 

X 
X 
X 
X 
X 

X 
X 
X 
X 

X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 



* indicates that Level I end Level II operations 
differ for thl6 command. 
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Hardware Reflects Software 

You are probably familiar with the general 
operating characteristics of your TRS-80, 
including BASIC commands and how the 
machine responds to them. These responses are 
characteristics of how the software treats the 
hardware, and also of how aspects of the 
hardware act independently of the software. 

The hardware inside the TRS computer can be 
broken into seven major sections: 

1. CPU Hardware 

A. Central Processing Unit (Z-80), its clock, 
power-up, and reset circuitry. 

B. Decoding of CPU status signals into 
memory/peripheral access signals such as 
read, write, input, output. 

C. Buffering of address and data signals to 
and from the CPU. 

2. Program RAM Control 

A. Refresh signals to maintain memory in 
dynamic RAMs. 

B. Address decoding able to distinguish 4K 
and 16K RAMs. 

C. Address multiplexing for dynamic RAM 
address lines. 

D. Read/Write signals to RAMs. 

3. Video RAM Control 

A. Address decoding for video RAM. 

B. Read/Write signals to video RAM. 

C. Input to character generator, timing, 
blanking signals so characters do not run off 
the screen. 

D. Access management between display and 
CPU. 

E. Alphanumeric/graphic switching and 
graphics character circuitry. 

4. Keyboard 

A. Address decoding for keyboard. 

B. Address/data buffering and read signals. 

5. ROM Control 

A. Address decoding for 4K and 12K ROMs 
(Level I or Level II). 

B. Outboard decoding for three 4K Level II 
ROMs or two Level II ROMs. 

C. Read signals. 



6. Output Controls 

A. Parallel-to-serial conversion from 
character generator. 

B. Horizontal and vertical video sync 
circuits, video output circuit. 

C. Cassette motor, cassette data, and 32 
character video output control. 

D. Cassette audio output circuitry. 

7. Power Supply 

A. Three regulated voltage outputs. 

B. Short-circuit protection. 

Each of these sections plays a major role in the 
operation of the TRS-80, and few could be 
trimmed or eliminated without completely 
changing the character of the computer. The rest 
of this Chapter will be devoted to detailing those 
aspects of the TRS which are significant to 
customizing the hardware or software of the 
machine. For a more comprehensive 
examination, including timing diagrams and 
discussion of each signal line, turn to the 
Technical Reference Handbook. 

CPU Hardware 

The master clock is produced by the 
oscillations of a 10.6445 MHz (million cycles per 
second, or Megahertz) crystal. A countdown 
circuit (Z56) divides this by 6, producing the 
running frequency of the Z-80, 1,774,083 clock 
cycles per second. This is generally called the 
TRS-80's 1.77-MHz clock. 




Figure 2-40. Clock circuit area of TRS-80. 

It's interesting to note that there are several 
other clocks on the computer's board, some 
already wired in place, and others which can be 
created by interconnections. At pins 11 and 9 of 
Z56, 3.548 MHz is available, twice the normal 
TRS-80 speed. Pin 2 of Z43 clocks at 5.322 MHz, 
faster than the Z-80 can run, but when connected 
to pin 14 of Z56, a 2.661-MHz clock is available. 
This is 1.5 times the normal clock speed. Both 
the 2.661 MHz and 3.548 MHz clock rates will be 
used in Chapter 4. 
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HALT 



NRESET 




Upon power-up, the processor's RESET input, 
which sets the program counter running at 0000, 
is triggered by Z53 in combination with Z52. The 
capacitor C42 takes time to charge completely, so 
the RESET line is held down for a few 
milliseconds after the rest of the system comes up 
and is stable. This power-on reset is a 
convenience so the user doesn't have to press a 
special reset button just to get the system going. 
Other computers, such as the Ohio Scientific 
series, demand that inconvenient action. 

The TRS-80 design creates Read (RD), Write 
(WR), Input (IN) and Output (OUT) signals 
from the Z-80's Memory Use Request (MREQ), 
Input/Output Use Request (IORQ), Write (WR), 
and Read (RD) signals.These are combined by 
Z23, in the correct order to do that. The four Z-80 
signals are not wired to the edge card connector, 
so certain functions (such as mode and mode 2 
interrupts - see supplement to Chapter 5) cannot 
be used. 



SYSRES'E 
Figure 2-41. Power-up reset circuit area of TRS-80. 
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Figure 2-42. Read/write status, multiplexer of TRS-80. 
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A TEST line is provided to 'float the bus' - in 
other words, the Z-80 becomes invisible, allowing 
another device to take over operation of the 
computer. Some outboard devices which speed 
up the TRS-80 use this feature, essentially taking 
control of the memory and peripheral devices by 
bringing the TEST line to ground. Z52 goes high 
in response, electronically disconnecting the 
Z-80's address and data bus from the circuitry. 
(Note that using the TEST line without 
memory-refresh backup circuitry on the outside 
of the computer will result in loss of memory 
contents). 



+ 5V 

o 



TEST* 



R58 
4.7K 



5V 

1 



► ENABLES 



251; 



^BUSRQ 
Figure 2-43. Test line circuit of TRS-80. 

In normal operation, the Z-80 lines are active 
and buffered by Z38, Z39, Z22 and part of Z55 
(address), Z75, Z76 and the remainder of Z55 
(data). Except when the TEST line is used, the 
address buffers are always active. The data 
buffers are active under any circumstances, 
either in their READ or WRITE configuration: 



Except for the memory refresh information, 
this completes the role of the Z-80 CPU circuitry 
in the TRS-80. 



Program RAM Control 

The CPU is also used in the creation of the 
signals needed to refresh the dynamic memories. 
Since the TRS-80 uses dynamic RAMs, (see 
Chapter 5 for details on this), the normal refresh 
(RFSH) output of the Z-80 is less than useful, at 
least in the minds of the computer's design 
engineers. That RFSH signal, which is output 
when the computer is not using the memory, is 
ignored in the TRS-80. 

Instead, the processor's MREQ line, when 
buffered, serves as a memory address row signal. 
The master clock is used in conjunction with the 
Z-80's RD and WR lines to produce a memory 
address column signal (column-address strobe, 
CAS) and a multiplex signal (MUX) to switch 
from row to column. This serves a very useful 
double purpose: not only does it refresh memory 
when the processor is not specifically using the 
memory in the program, but it serves as the 
address-select lines when the Z-80 processor is 
using memory. Refer to the Z-80 Technical 
Manual for details on the timing of these signals. , 




0. 

HAS* AI5 



$ Q Q ^066$ 



AI3 A!2 All AlO 



A9 A8 A7 46 AS A4 



V 9 V Q $ 



WS* BD* D7 



»Z25-4J 



Figure 2-44. Address/data buffers of TRS-80. 
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Needless to say, should any of these signals fail 
or operate inconsistently, the memory will not 
retain its contents for very long nor will a 
program even run which uses dynamic memory, 
because its address may not be selected. 

The next subject is memory management. 
This is basically the means by which the 
processor gets to the memory it wants to use. The 
heart of this sequence is found in Z35 and Z51, a 
pair of multiplexers which send the low bits of 
the memory address to the dynamic memories; 
flip from low bits to high bits according to the 
incoming multiplex (MUX) signal; and send the 
high bits to the memory. The memory, upon 
receiving these addresses together with the 
previously mentioned RAS and CAS signals, 
knows which address is being selected, and 
responds accordingly. 

The DIP (Dual Inline Package) shunt Z71 
plays an important role here. Specifically, it 



Figure 2-45. Memory select/refresh of TRS-80. 




routes the signals to the multiplexers in such a 
manner that the computer can distinguish 
between 4K and 16K RAMs. Stated simply, 
what is a memory-chip select line for 4K RAMs is 
a complete address line for 16K RAMs, and a 
partial address line for 8K RAMs (which the 
TRS-80 was designed to use also). Thus, the 
higher address lines must be prevented from 
appearing at the CE (chip enable) input of the 4K 
RAMs. If this were to happen, phantom memory 
would appear, and a running BASIC program 
(and the power-up memory test) might try to use 
those phantom bytes: 



H3I-2 
231-5 




All 



Figure 2-46. Memory multiplex, CAS, RAS & memory. 



Figure 2-47. XT I and decoding scheme of TRS-80. 

Only a WR signal is used to trigger these 
RAMs, as a high signal on their WR lines 
prepares them to read data. The CE (Chip 
Enable) determines if data should be placed on 
the data bus, where it is buffered by Z67 and Z68. 



Video RAM 

Video memory is used in three ways: it is 
written to by the processor, read from by the 
processor and read from by the video display 
circuitry. In fact, it is constantly being read by 
the video display circuitry except when the 
processor demands attention. 

The circuitry is complicated, and if you are 
interested in details, turn to the Technical 
Reference Handbook. In brief, memory is 
accessed by the processor using the Read (RD) 
and Write (WR) lines in conjunction with the 
decoded video area address-select line (VID). 
The display circuitry uses the video memory in a 
more complex manner: characters are output to 
Z27 and Z28, and these in turn are fed to Z29 (a 
character generator) and Z8 (a multiplexer). The 
characters, whether alphanumeric or graphic, are 
fed to Z10 (a shift register), where they are fed, a 
bit at a time, to the video output circuitry 
(beginning at the input of Z30). 
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The character generation process is 
complicated by several factors. The dots that 
make up each letter must be fed to the video 
output circuitry only when the video monitor's 
electron beam is sweeping the visible part of the 
screen. The visible part of the screen does not 
include the upper, lower, left or right borders. 
The timing process must continue correctly even 
when the CPU is using the video memory. 

Because each letter is made up of twelve vertical 
dots, and each line is made up of 64 characters 
with six vertical dots each, different parts of the 
characters must be output to the screen at 
different times. 

Again, the Technical Reference Handbook 
covers this in detail, but a few decoded signals are 
important. The output of Z30, pin 10, is the final 
BLANK signal; no characters are output when 
this signal is active. Presence of characters or 
graphics in the border areas points to problems 
with this line. 

The signal to shift video bits out to the video 
circuit is provided by Z26. Pin 8 controls 
alphanumeric bits, pin 6 controls graphics bits. 
Mangled screen characters may be traced to here, 
or to any of the seven chips that select characters: 
Z65, Z50, Z12, Z32, Z64, Z49, and Z31. This is one 
of the most unpleasant areas to attempt to 
diagnose. 



The 32/64 character mode select (MODESEL) 
is provided by Z59, pin 9, and changes the speed 
of the video clock at Z43. Failures in either Z59 or 
Z43 will show up as a lockup in one mode or the 
other. 

The presence of bit 7 determines if the 
computer is to output graphics or alphanumerics, 
and that signal (DLY BIT 7) is output in normal 
and inverted forms from Z27 pins 2 and 3. 
Failure in either mode can be examined here, or 
at the outputs of Z26, pins 6 and 8. 



Keyboard 

The keyboard is very different from the video; 
it's just a simple key matrix. When the keyboard 
address area is read, the KYBD line from Z36 pin 
1 1 triggers the keyboard integrated circuits (Z3 
and Z4 on most keyboards) into action, 
outputting information to the data bus. 

The data to be output is determined by the low 
eight bits of the address requested. The specific 
address requested is inverted, and a low signal is 
detected whenever a key in that matrix row is 
pressed. The inverting buffers to the data line 
provide the appropriate row information. For 
details on how the software interprets this 
switching matrix, see the supplement to this 
Chapter. 




Figure 2-48. Character generator and shift register. 
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An interesting aspect to this is how the 
depression of any key may be detected. If 
address 387F is sought, all the address lines 
(except SHIFT) will become active, and the 
presence of any depressed key (except SHIFT) 
will appear on the address bus. Requesting the 
data at address 38FF will return the presence of 
any key including SHIFT. This is useful in 
creating a keyboard buffer, which is built from 
characters detected whenever the INTerrupt 
line is triggered. 

In other words, the interrupt line triggers, and 
the program moves to the interrupt service 
routine. This routine reads address 387F, and 
the presence of any depressed key can be sensed. 
If one is pressed, it can be accepted and 
evaluated. Otherwise, the interrupt routine 
promptly returns to the program in progress. 

This is also a valuable addition to INKEY$ in 
some situations; see 'Peeking the Keyboard' in 
Chapter 3. 

ON KEYBOARD PCB 




ROM Control 

Selecting the ROMs is the biggest sticking 
point in the Model I. This selection is 
accomplished by Z3, another DIP jumper shunt, 
in conjunction with Z21, a 74LS156 
demultiplexer. Z21 joins various address lines to 
produce VID, KYBD, and MEM for the video, 
keyboard, and dynamic RAMs and to produce 
variants on the ROM line. 

Two-chip Level I sets were selected by a 
combination of methods, all of which are detailed 
in the Technical Reference Handbook. Each 
ROM was 2K bytes in size. Three different 
versions of the board were publicly released, 
marked 'A', 'D' and 'G\ Each had a different 
hard wired method of decoding ROM. An 
occasional 'B' or 'F' board has been reported to 
me, but I have never seen one. Follow Technical 
Reference Manual descriptions carefully to 
make sense of these Level I lines. 

Some of these ROMs were EPROMs with 
identical pinouts, so a 'ROM A' and 'ROM B' pair 
of lines were needed so these memories would not 
conflict. 

Later Level I ROMs had the selecting circuitry 
masked right onto the chips, which removed that 
conflict. Finally, a single 4K ROM was 
introduced to eliminate these difficulties 
completely. 



II 16 10 13 

Figure 2-49. Keyboard matrix of TRS-80. 
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The Level II ROMs were for a long time quite 
consistent as a three-chip set, 4K bytes of 
memory in each one. A separate, piggybacked 
board was used. The decoded ROM line, in 
conjunction with address lines 11, 12 and 13, feed 
a 74LS42 wired as a demultiplexer. Each ROM 
selects a bit differently, and the combination of 
signals allows the memory areas from 0000 to 
OFFF, 1000 to 1FFF, and 2000 to 2FFF to be 
selected. 

In later Model I's, the three-chip set was 
reduced to two masked ROMs with different 
select characteristics. The piggyback board 

disappeared, and the two ROM sockets, once 
used for Level I, were now used for Level II. A 
modification to remove the two-chip ROM set, 
and make room for the addition of Level I, is 
presented elsewhere. 

Output Controls 

Some of the output controls have already been 
pointed out, including the parallel-to-serial 
conversion of video characters and the 32 
character video control. The latter is part of a 
latch which is activated by information sent to 
port FF. Z54, Z36 and Z52 together decode port 
FF, and this is brought together with the 
computer's IN and OUT signals. The result is a 
pair of lines marked INSIG and OUTSIG, which 
are used to activate the input/output circuitry. 

A latch, Z59, holds the cassette motor on or off, 
and also locks the video into 32- or 64-character 
mode. It is also latched on and off to create the 
500-baud pulse rate of data to the cassette player. 
This output signal is purely digital, as opposed to 
the input signal (discussed below). 

+ 5V 



Figure 2-50. 74LS42 Level II demultiplexer of TRS-80. 
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Figure 2-51. INSIG and OUTSIG area of TRS-80. 




MQDESEL Figure 2-52. Output data latch area of TRS-80. 
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It would have been possible to have used Z54 to 
decode port FF directly, without using Z52 or 
Z36. Whether or not this was a design expansion 
consideration, you can use it as such since ports 
FF (255 decimal) and FE (254 decimal) are 
created by Z54 and the separate low-bit data line. 
In Chapter 4 port FE will be used for video and 
speed changes. 

Cassette input is provided via a low-pass filter, 
through parts of Z4, where it is turned from low 
grade audio into a reasonable digital signal. 



When INSIG is activated, whatever data is 
present at the cassette input is switched onto the 
data bus, and the CPU can read it. Then 
OUTSIG may reset the flip-flop created by Z24, 
when the program is ready to read the next piece 
of data from the cassette input. Note that the 
input can be any audio signal. The cassette port 
is not limited merely to taped data, but can be 
used to decode communications, shortwave, and 
ham transmissions, or test for the rise of voltage 
to a triggering level. 
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Figure 2-53. Cassette data shaping circuit of TRS-80. 
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The complex video divider chain provides 
HDRV and VDRV (horizontal and vertical 
drive) signals for television monitor 
synchronization. These signals are fed into a 
group of digital phase-shifting circuits which 
permit the signal to be adjusted on the video 
screen. 
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Figure 2-54. Horizontal and vertical phase circuitry. 
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The signals are mixed together at Z5 to provide 
a complete syncronization signal, and this sync 
signal is mixed with the video signal by Z41, Ql 
and Q2. The result is a composite video signal 
which is capable of running a standard television 
monitor, or an RF modulator. The RF modulator 
signal can then drive an ordinary television. 




Figure 2-55. Video mixing circuit of TRS-80. 

Power Supply 

Refer to the Technical Reference Handbook 
for an excellent description of this circuitry. 
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Wire-Wrapping Technique 

It's not without a bit of hesitation that I 
attacked many of the hardware projects 
presented in this book. Some are simple, but 
many, particularly those using memory circuits, 
need many connections. The wiring is not 
complicated, just-tedious. 

If you work carefully, all is likely to be well; 
but even a touch of haste will encourage 
confused connections. It is in these cases 
especially that wire-wrapping is the technique 
to use. 

Wire-wrapping is not only easier than 
soldering, it is secure, simple, easier for 
correcting mistakes - and less costly. For 
wire-wrapping, you will need wire-wrap sockets, 
which are sold by most hobbyist supply houses 
including Radio Shack. Likewise, wire-wrap 
wire and a simple hand tool are used for the 
process. Here are the steps: 



1. The wire, still connected to the spool, is 
inserted in the V-shaped stripping slot. 
Insert between one half and one inch of wire. 

Pull downward from the V, and the wire will 
slip out, leaving a piece of insulation in the 
stripper, where it can be shaken out. 

2. Look carefully at the end of the 
wire-wrap tool. There is a small hole, meant 
to fit over the pins of a wire-wrap socket. 
Next to it is a half-circle, into which you 
must slide the stripped wire. The stripped 
portion will slide up a groove in the side of 
the tool, stopping where the insulation 
begins. 

3. When the wire is in place, pull it 
sharply but gently upward, and slide the tool 
on the wire-wrap socket. Holding the wire 
firmly, spin the tool in your hand. The wire 
will wind up on the socket pin, freeing itself 
from the tool. Remove the tool. The 
wire-wrapping is complete for that end of 
the connection. 

4. Cut the wire to a length that will 
comfortably reach its destination, and then 
some. Strip the end of it, and repeat the 
process above. The connection is complete. 
Don't forget to use different colors (white, 
yellow, red and blue are generally 
available).This will help you distinguish your 
connection patterns if changes become 
necessary. 



Peripheral Addressing 

The bulk of the external devices attached to 
the TRS-80 do their own address decoding work. 
Some have become standardized by conventions 
of their use, and others have been used somewhat 
haphazardly by various manufacturers. 

Table 2-6 
Addressee reserved: 



300D-37CF Exetron Stringy-Floppy 

Persons I Microcomputer Fsetload 
Persons I Microcomputer REX-BO 
Peripheral People Memory Sidecar 

Communications Status (Expansion) 
Communications Data [Expansion) 
Interrupt Flip-flop [Expansion) 
Disk Drive Select Latch (Expansion) 
Csssette Drive Selsct (Expansion) 
Lins Printer I/O [Expansion) 
Percom Electric Crayon I/O 
Percom Speak-2-He-2 
Microcompetible Printer Buffer 
Floppy Disc Controller (Expansion) 
Electronic Systems Serial I/O 

Table 2-7 

Output Ports Reserved: 



37DE 
37DF 
37E0 
37E1 
37E4 
37EB 



37EC 
37F8 



[Selectab 
[Selecteb 
(Selectab 
(Selectab 





1 

2 

7 

B 

55 

206 

209 

232 

233 

234 

235 

254 

255 



Adoresseble 



Is) Alpha Product Interface Devices 
la) Alpha Product Interface Devices 
Le) Alpha Product Interfece Devices 
le) Alpha Product Interface Devices 
JPC Poor Men's Floppy System 
Electronic Systems Serial I/O 
Microperiphera I Mi croconnection 
MicropeHpherel Mi croconnection 
Lynx Modem 

Radio Shack RS-232 Board 
Lynx Modem 

Radio Shack RS-232 Board 
Lynx Modem 

Radio Shack RS-232 Board 
Lynx Modem 

Redio Shack RS-232 Board 
Archbold High Speed Board 
Mumford Micro Speed Hod Board 
Most Internal User Modifications 
Cassette Dsta I/O [Internal) 
BO-Grefix (Programme) 
Cassette Motor Snitch [Internal) 
Video Cherecter Size Letch (Internet) 
Simutek T-Baep Addition 
Mullen Computer M-80 Interfece 
Quent Systems PPI-BO I/O Port 
Orion Instruments In-Circuit Emulator 
Optimal Techno logy EPHOM Programmer 



Table 2-8 
Other Peripheral Device Uses 
Unaddrsssed (using bus control signals): 



Cecdat Soft»are/Hardxare Extension, Ths Petoh 
Hicrogramma Programmable Graphics, Grafix-80 
Microcompetible Company, The 225* Solution 
Alpha Product Stick-BO Joysticks 
SEL IEEE-48B to TRS-80 Interface 
Xitek STD Bus I/O Card System 

Unaddrsssed (using cessstte I/O signals): 



Most aval labia Light Pane, including 
Most sveilable Ceeestte Dsta Digitizers, Including 
Acu-Oata, Date Dubber, E-Z Loader 

Unconnected (using RFI interference pickup): 



Micro-Mega CPU Monitor 
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Soldering Technique 

For projects from scratch, soldering should 
be considered the final process, the actions of a 
self-assured, confident hobbyist. For 
modifications, it is a necessity. In either case, 
and whether you are a micro-acrobat or 
distinctively clumsy like me, you can solder 
well. The requirements are patience and good 
solder. 

To start, make sure you are using an iron in 
the 25 to 40 watt range, never a soldering gun. 
The solder should be high quality, multicore 
solder. It is expensive, but will save many grief 
stricken hours tracing 'cold solder joints', or 
removing globs of dull solder from between and 
under integrated circuits. 

1. Clean the soldering iron tip, and heat 
the iron. Flow fresh solder on the tip to 'tin' 
the tip, which will help the solder flow from 
the tip of the iron to the part to be soldered. 
If the iron has been used, clean any 
encrusted material from the tip, and use 
coarse emery paper to shine the solder. If 
the tip gets deformed, bent, or very 
corroded, file it sharp with a fine file, and 
re-tin the tip. 




Tin the tip. 



2. Keep an old sponge handy, slightly 
damp. Run the tip of the iron quickly over it 
as you solder to remove the excess flux. 
Always use a soldering iron holder (usually 
provided with an iron); if you don't, you'll 
wish you had the first time you burn a large 
hole in your imitation walnut, vinyl-topped 
desk. 




minim - ' 



3. In the olden days, the rule was 'heat the 
parts, not the solder'. Forget it. Make sure 
the iron is no hotter than 40 watts (and 
remember never to use a soldering gun) and 
that the parts you are about to solder are 
very clean. Place the iron against the part, 
making as much contact with it as possible 
along the angled tip of the iron. Place the 
end of the solder at the juncture of the iron 
and the part, and flow just enough solder to 
make a clean, shiny, flowing connection. 




Briny solcer, parts ano 
iron into contact. 



4. Remove the iron immediately and let 
the part cool. If a wire is being soldered, 
hold it still until the solder becomes cloudy 
and cool, or else an imcomplete connection 
may result. 




3. Lift iron and 

so Lour simultaneously . 

5. If solder bridges develop between 
connections that are very close together, 
don't try to suck up the solder with the iron; 
you can only overheat the parts that way, 
and end up with blobs of solder and flux. 
Instead, use solder wick or solder-up to 
remove the excess solder, and start again. 
Let the parts cool before soldering again (a 
half minute should be enough). 





b. Eiao so Icier connection - 
no contact nth boaru 
(biaevisw) . 



Beo sotcur connection - 

no contact with pin 

16A Bioeview) (6U topview 
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On the Keyboard Scan 

Arrows? Control codes? Autorepeat? 
Whatever it is you would like, that has to do with 
the keyboard, you can do with the TRS-80. The 
designers of the machine chose not to use an 
ASCII (Amercan Standard Code for Information 
Interchange) keyboard . . . one that outputs a 
code for each key pressed; instead, the keyboard 
is a matrix of switches. Because of this decision, 
the TRS-80 keyboard can be extremely versatile 
with a minimal body of software. 

First let's take a look at the keyboard matrix 
itself. If you have been programming in machine 
language, or even relatively sophisticated 
BASIC, this map will be familiar: 



address 03EB: 



Aadresses 






Keys 






3801 
3802 
3804 


1 
H 
P 
X 


a 

BIT 
SHIFT 

01 


A 
I 

D 

Y 

1 

9 

CLP 

02 


B 
J 
R 

Z 

; * 

BHK 
04 


C 
K 
S 


D E F 

L M N 

T U V 

RESERVED... 


G . 
. 
W . 


3810 

3820 
3840 


3 

; + 
UPAR 

08 


4 5 6 

,< -= .> 

DNAR LFAR RTAR 

RESERVED 


7 . 

/? . 
SPC . 


Data: 


10 20 40 


80 . 



At first, the arrangement of the address lines 
and data information may seem unappealing. 
What is the use of having address and data 
information that doubles at each change? Why 
not just use 3801, 3802, 3803 and so on? The 
reasons will eventually become apparent - in the 
ease and speed of the keyboard scan (and in the 
low cost of the hardware), but consider this 
binary for a moment . . . 



00000001 
00010000 



00000010 
00100000 



00000100 
01000000 



D0001000 
10000000 



. . . and there you have it. The bit is bumped 
along for each keyboard row and column, so that 
the presence of a single active bit instantly 
identifies any of the (potential) 64 keys. 

The entrance to the keyboard scan is made 
with a jump from address 4016 in the ROM's 
RAM switchboard. Normally at power up, the 
jump address 03E3 is put in place, and the 
keyboard scan is entered at that point. Registers 
BC, DE, HL, and A are used in the scanning 
process: 



03 E3 


21 36 40 


L0 


HL.4036 


03 E6 


01 01 38 


LD 


BC.3B01 



The HL register pair points to the first RAM 
location at which the keystrokes will be stored. 
BC is set to look at the first row of the keyboard, 
whose memory map is 3801 to 3880 as noted 
earlier. Register D is set to zero, and it will 
become a 'row counter'; the process begins at 



03 EB 
03 EC 



UA 



L0 
LD 



A, [BO 
E,A 



The accumulator reads the data at BC (recall 
at the outset it is pointing to the first keyboard 
row, 3801). The information it finds is stored in 
the memory location pointed to by HL (4036). 

Okay so far. Now comes some of the 
interesting stuff that distinguishes this scan as 
an excellent piece of writing: 



03 ED 


AE 


X0H 


(HL) 


03EE 


73 


LD 


[HU.E 


03 EF 


A3 


AND 


E 


D3F0 


20 08 


JH 


NZ.03FA 



This short segment is responsible for the 
'rollover' capabilities of Level II. The contents of 
the accumulator (the keystroke, if found) is 
XORed with the previous contents of 4036. 
Recalling how the XOR function works, we 
discover that if the key pressed was the same as 
the previous one at this row, the accumulator will 
be 'toggled' to zero. In any case, the current 
keystroke, whatever it is, is now saved in 4036 (so 
that the next time 'round, it knows if a key is still 
pressed). 

If the key was the same, AND E will be the 
result of A-toggled-to-zero AND the found 
keystroke ... or zero. If there was no key 
pressed, the result will be A XORed with HL 
(which is essentially irrelevant) AND 
E-which-is-zero ... or zero. The test at 03F0 is 
for not zero. Under these conditions, it fails, so 
the program continues: 



03F2 


14 


INC 


D 


03F3 


2C 


INC 


L 


03F4 


CB 01 


RLC 


C 


U3F6 


F2 EB 03 


JP 


P.03EB 


03F9 


C9 


RET 





The 'row counter' (D register) is incremented, 
and the low-order byte of HL is incremented (to 
storage address 4037), and the low-order byte of 
BC is rotated. Recalling the keyboard matrix, we 
can see that this command to rotate moves us 
from 01 to 02, from 02 to 04 from 04 to 08, from 08 
to 10 and so on. That keeps track of the row that 
the scan is looking at, and as long as the result of 
the rotate is positive (bit 7 low), the loop will 
travel back to 03EB, where the next row will 
undergo the same testing as each previous one. 

When RLC C shifts the row pointer to 3880, 
then bit 7 will be high (10000000); this is 
'negative' in Z-80 architecture, and the loop falls 
through. Why does it fall through before 
checking the contents of address 3880? Because 
the only thing in this row is the shift key; it does 
not offer a decipherable code by itself, but merely 
modifies the information found when some other 
key is depressed. This explains why, among 
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other peculiarities, INKEY$ does not 
acknowledge SHIFT alone. 

When the loop falls through, the program 
encounters a RETurn from subroutine, which 
directs it immediately back to the rest of BASIC. 
The routine is remarkable, looping through just 
over 100 bytes when the keyboard is clear. 
Although not as time-efficient as obtaining input 
from a memory-mapped ASCII keyboard, it is 
quite speedy, and offers considerably better 
'rollover' than many encoded keyboards. 

When a key is pressed, the program jumps to 
03FA, and is able to provide upper/lower case 
ASCII codes, special functions, and, incredibly 
enough, all of the 'missing' ASCII control codes 
(form feed, ring bell, etc.). Let us now follow it 
through: 



03FA 


bF 


LD 


E,A 


03FB 


7A 


u> 


A,D 


03FC 


U7 


RLCA 




03FD 


07 


RLCA 




03FE 


07 


RLCA 




03FF 


57 


LD 


D,A 



The position of the keystroke found has been 
stored in register E - recall that this is the 
'column' of the keystroke. The row itself is not 
yet accessible, but the row counter (register D) is 
crucial to determining it. After E is saved, the 
accumulator is loaded with the value in this row 
counter, and rotated to the left three times. For 
those shaky in their binary arithmetic, this is the 
effect: if a decimal number is 045, a left rotation 
makes it 450. This is multiplication by ten. If a 
binary number is 010 (decimal 2), a left rotation 
gives 100 (decimal 4) ... in other words, 
multiplication by two. Therefore, three left 
rotates gives us 2 x 2 x 2, or multiplication by 
eight. That result is saved back in register D. 

The purpose of this clever ploy will soon 
become clear: 



0400 


0E 01 


LD 


C,01 


0402 


78 


LD 


A,C 


0403 


A3 


AND 


E 


U404 


£0 05 


JH 


NZ.040B 



Here the C register is set to 1, sucked up by the 
accumulator, and ANDed with E (remember E 
still contains that keystroke column byte). If the 
result is not zero (that is, if E equals 1), then the 
loop falls through and the program moves on. 
But have a look at what follows: 



0406 14 

0407 CB 01 
0409 18 F7 



INC D 

RLC C 
JR 0402 



What is this about? Well, the D register, which 
contains 8 times the row value, is being 
incremented each time C is being rotated . . . 
making the lower three bits of D serve now as a 
column counter! Whoa, you say, back up there. 



Okay, here it is: the original value in D could have 
been through 6, depending on the row in use. 
When shifted three times, the possible values 
become 00, 08, 10, 18, 20, 28 and 30. Each of these 
possible values, when incremented through all 
seven possible columns, might contain 00 to 07, 
08 to OF, 10 to 17, etc., up to 37. This gives us a 
complete, distinct value to represent each key. 

Now a fairly crude process of hunt-'n-peck 
begins. The status of the SHIFT key is checked, 
and set aside in register B. The demultiplexed 
keystroke value in register D is snapped back 
into the accumulator, and the comparisons take 
off: 



040B 


3A 60 36 


LD 


A, (3880) 


040 E 


47 


LD 


B,A 


040F 


7A 


LD 


A,D 



The character search can be followed through 
several branches; we will start with the most 
straightforward, and progress through some of 
the unique (and little publicized) aspects of the 
TRS-80 keyboard output. 

The program adds 40 to the character value 
(address 0410), and checks if the result is greater 
than or equal to 60 (0412). 



. CHAR + 40 is 


■ 


A 


B 


C 


D 


E 


F G 


Less than 60 


H 


I 


J 


K 


L 


H 


N 


. (40 + 00 to 1F) 


P 
X 


D 

Y 


R 

Z 


S 


T 


u 


V W 


. CHAR + 40 is 





1 


2 


3 


4 


E 


6 7 


. 60 or greater 


6 


9 


;* 


; + 


,< 


-= 


.> /? 


. 140 + 20 to 37) 


ENT 


CLB 


BRK UFA 


DMA 


LFA 


RTA SPC 



If the compare finds a value less than 60, the 
routine rotates the SHIFT key value - which had 
been saved in the B register (0416). If SHIFT is 
released, the value in B is zero, and hence the 
rotate resets the carry flag (0418). The program 
moves directly to the terminal steps at 044B (to 
be discussed later). At this point, the character 
contained in A would be in the range 004-40 to 
1F+40, the ASCII values for upper case (@, A-Z, 
left bracket, separator, right bracket, carat, and 
cursor). This is the software routine that causes 
the bizarre 'inverted' shift pattern on the 
TRS-80 ... no shift for upper case! 

If the character test at 0412 returns a value 
greater than or equal to 60, then 70 is subtracted 
(0429). No carry is generated if the test value was 
greater than or equal to 70, so this further 
separates the keyboard. See the diagram below: 



. 60 to 6F minus 70 

carries; result 
. is F0 to FF 


12 3 4 5 6 7. 
B 9 l»;+,<— .> /? . 


. 70 to 77 nfnus 70 

does not carry; 
. result Is 00 to 07 


ENT CLfl BRK UPA DNA LFA RTA SPC . 
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5000 



At address 043D, the value in the accumulator 
(00 to 07) is rotated left, producing the even 
values from 00 to 0E. The SHIFT byte in B is 
rotated right into the carry flag; if a carry is 
generated, the accumulator value is incremented 
(0442), providing the values 0+1, 2+1, 4+1 and so 
on - in other words, the odd values from 01 to OF. 

What follows is a classic example of machine 
language table look-up. HL is set to 0050, the 
address of the table in ROM; BC will be used as 
an offset, with B set to and C made equal to A. 
When BC is added to HL, a resultant address 
(0050 to 005F) is produced, and the contents of 
that address is loaded up by the accumulator. 
Here is a look: 



0443 


21 50 


00 


LD 


W.,0050 


0446 


4F 




LD 


C,A 


0447 


06 00 




LD 


B,0 


0449 


09 




ADD 


HL.BC 


044A 


7fc 




LD 


A,(HL) 


G44B 


57 




LD 


D,A 



What do we find at 0050 to 005F? ASCII 
control codes. That result is stored in the D 
register (044B) before the termination sequence. 

Table 2-9 
Aodress Contents TRS-80 Action ASCII Description Keyboard Entry 



5000 CDC901 

5003 F3 

5004 AF 

5005 0E30 
5007 211030 
500A 112400 
5000 D5 
500E 110138 
5011 0608 



5013 1A 

5014 CB47 



DO 50 
0051 
0052 
0053 
0054 
0055 
0056 
0057 
0058 
0059 
00 5A 
00 5B 
00 5C 
00 50 
00 5E 
06 5F 

00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
002B0 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 



00 
00 
1F 
1F 
01 
01 
5B 
1b 
DA 



Carriage Ret. 
Carriage Ret. 
Clear Screen 
Clear Screen 
Break 
Break 
Up Arrow 
Eoit Escape 
Line Feed 



1A 100) »See text 



08 
18 
09 
19 
20 
20 



backspace 
Beckspace Line 
Horizontal Tab 
32-Char. Mode 
Space 
Space 



Carriage Ret. 
Cerrlage Ret. 
Unit Separator 
Unit Separator 
Start of Heading 
Stert of Hsaoing 
Left Bracket 
Escape 
Line Feed 
Substitute 
Beckspace 
Cancel 

Horizontal Tab 
End of Medium 
Spece 
Space 



Alright, we have upper case ASCII and TRS-80 
control functions. How about the rest? Back up 
now to the test for SHIFT, at 0416. If such a shift 
is present, the value in A (40 to 5F) is increased by 
20 (60 to 7F). These are the ASCII codes for lower 
case (@, a-z, left brace, separator, right brace, 
delete). The resultant code, as usual, is saved in 
the D register. 

But what follows is curious: 



ENTER 

SHIFT ENTER 
CLEAR 

SHIFT CLEAR 
BREAK 

SHIFT BREAK 
Up Arrow 
SHIFT Up Arrow 
Down Arrow 
SHIFT Down Arrow 
Left Arrow 
SHIFT Left Arrow 
Right Arrow 
SHIFT Right Arrow 
Space 
SHIFT Space 



tttttttttttttittittttttttttiiittttttttttttittttttttttit 

SIMPLE ACTIVE KEYBOARD DISPLAY ROUTINE TO SHOW THE USE 
AND PHANT0MING OF KEYS AS THEY ARE PRESSED BY THE USER 

DENNIS BATH0RY KITSZ, R0XBURY, VERMONT 05669 

tfiiimittittrtnuiiintniiiiHiuitiiitittnimiii 



ORG 



5000H 



tttttitttttttttittttttttttttntitttitiittttttmttttttt 

CLEAR SCREEN, DISABLE INTERRUPTS, CLEAR ACCUMULATOR, 
GET "0" CHARACTER, SCREEN POSITIONS, SCREEN OFFSET, 
AND BEGINNING OF KEYBOARD FOR TEST; ALL ARE SET UP ONCE 

ntunututtttttmttutttittitttttttttiHttttiHUit 



CLEAR SCREEN TO START 
KILL ALL THEM BOTHERS 
CLEAR ALL FLAGS 
THIS IS THE "0" CHAR. 
ADDRESS NEAR SCREEN CTR 
DISTANCE BETWEEN LINES 
SAVE LINE ADDER VALUE 
DEFINE FIRST KEYBOARD 
NUMBER OF LOOPS TO DO 



; tmttmtttttnmtttititnttinnuimitinnHmttt 

; TEST EACH ROW OF THE KEYBOARD, COLUMN BY COLUMN 

; tttttttttittttttt it it tit tttittittttttttttttittttttttttt 



CALL 


01C9H 


DI 




XOH 


A 


LD 


C.30H 


LD 


HL.3D10H 


LD 


DE.0024H 


PUSH 


DE 


LD 


DE.3801H 


LD 


B.08H 



LOOP 



LD 
BIT 



A,(DE) 

0,A 



FIRST ROW OF KEYBOARD 
CHECK FIRST KEY COLUMN 



D41D 


3A 40 38 


LD 


A, (3840 J 


0420 


E6 10 


AND 


10 


0422 


28 28 


JR 


Z.044C 



The keyboard is tested again, this time at row 
3840, data position 10 - the down arrow. If that 
key is not depressed, the program skitters right 
to the termination routine at 044C, with the 
lower case ASCII code ensconced in the D 
register. 

Why the SHIFT/down arrow combination? If 
the down arrow is depressed, the value in D is 
retrieved and placed in the accumulator (60 to 
7F), then reduced by 60, becoming . . . aha! . . 
. 00 to IF. The program jumps to the end 
sequence, with the accumulator clutching one of 
the complete set of 32 ASCII control codes! 

(There is an anomoly in earlier Level II ROMs: 
the code for the down arrow at 0059 is returned 
before the control code. Later ROMs placed a 00 
at 0059, resulting only in the return of a control 
code if SHIFT/down arrow was depressed.) 

So where are we now? Upper and lower case, 
TRS-80 and ASCII control codes. We need 
numbers and figures, and so we shall have them. 
Recall the second diagram: at 042B, the 
command row was separated from the numbers, 
which were left at F0 to FF. At 042D, 40 is added, 
resulting in possible values of 30 to 3F. A further 
separation is made via a comparison with 3C: 



30 to 3B 

[CP 3C result) 



4 
,< 



7 

/? 



If the comparison is less than 3C, a carry is 
generated. The usual SHIFT test is made (at 
0435), and if it fails, the value in A (30 to 3B) is 
maintained as the program moves into the end 
routine. These are the ASCII codes for numbers 
to 9, colon and semicolon. 

If the test value is 3C, 3D, 3E or 3F, no carry 
would be generated at 042F, and these values are 
XORed with 10. This toggles the high nibble 
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5016 71 


00410 




LD 


[HL),C 


FIRST DISPLAY A "0" 


5017 2B01 


00420 




JR 


Z.JUMP1 


DON'T CHANGE IF NO KEY 


5019 34 


00430 




INC 


[HLJ 


MAKE IT A "1" IF A KEY 


501 A 23 


00440 


JUMP1 


INC 


HL 


NEXT SCREEN LOCATION 


501 B 23 


00450 




INC 


HL 


...PLUS TWO 


501C 23 


00460 




INC 


HL 


...PLUS THREE 


501 D 23 


0D470 




INC 


HL 


...PLUS FOUR 


501 E CB4F 


00480 




BIT 


1,A 


SECOND KEYBOARD COLUMN 


5020 71 


00490 




LD 


IHU.C 


FIRST DISPLAY A "0" 


5021 2801 


00500 




JH 


Z.JUMP2 


DON'T CHANGE IF NO KEY 


5023 34 


00510 




INC 


[HL) 


MAKE IT A "1" IF A KEY 


5024 23 


00520 


JUMP2 


INC 


HL 


NEXT SCREEN LOCATION 


5025 23 


00530 




INC 


HL 


...PLUS TWO 


5026 23 


00540 




INC 


HL 


...PLUS THREE 


5027 23 


00550 




INC 


HL 


...PLUS FOUR 


5026 CB57 


00560 




BIT 


2. A 


THIRD KEYBOARD COLUMN 


50 2A 71 


00570 




LD 


(HL),C 


FIRST DISPLAY A "0" 


502B 2B01 


005B0 




JR 


Z.JUMP3 


DON'T CHANGE IF NO KEY 


5020 34 


00590 




INC 


(HL) 


MAKE IT A "1" IF A KEY 


502E 23 


00600 


JUMPS 


INC 


HL 


NEXT SCREEN LOCATION 


502F 23 


00610 




INC 


HL 


...PLUS TWO 


5030 23 


00620 




INC 


HL 


...PLUS THREE 


5031 23 


00630 




INC 


HL 


...PLUS FOUR 


5032 CB5F 


00640 




BIT 


3, A 


FOURTH KEYBOARD COLUMN 


5034 71 


00650 




LD 


IHL),C 


FIRST DISPLAY A "0" 


5035 2801 


00660 




JR 


Z.JUMP4 


DON'T CHANGE IF NO KEY 


5037 34 


00670 




INC 


IHL) 


MAKE IT A "1" IF A KEY 


503 B 23 


006 BO 


JUMP4 


INC 


HL 


NEXT SCREEN LOCATION 


5039 23 


00690 




INC 


HL 


...PLUS TWO 


503A 23 


0070D 




INC 


HL 


...PLUS THREE 


503 B 23 


00710 




INC 


HL 


...PLUS FOUR 


503C CB67 


00720 




BIT 


4, A 


FIFTH KEYBOARD COLUMN 


5D3E 71 


00730 




LD 


(HL),C 


FIRST DISPLAY A "0" 


503F 2801 


00740 




JR 


Z, JUMPS 


DON'T CHANGE IF NO KEY 


5041 34 


00750 




INC 


IHL) 


MAKE IT A "1" IF A KEY 


5042 23 


00760 


JUMP5 


INC 


HL 


NEXT SCREEN LOCATION 


5043 23 


00770 




INC 


HL 


...PLUS TWO 


5044 23 


00780 




INC 


HL 


...PLUS THREE 


5045 23 


00790 




INC 


HL 


...PLUS FOUR 


5046 CB6F 


00800 




BIT 


5, A 


SIXTH KEYBOARO COLUMN 


504B 71 


00810 




LD 


(HL),C 


FIRST DISPLAY A "0" 


5049 2801 


00820 




JR 


Z.JUMP6 


DON'T CHANGE IF NO KEY 


504B 34 


D0830 




INC 


IHL) 


MAKE IT A "1" IF A KEY 


504C 23 


00840 


JUMP6 


INC 


HL 


NEXT SCREEN LOCATION 


504D 23 


00850 




INC 


HL 


...PLUS TWO 


504E 23 


00860 




INC 


HL 


...PLUS THREE 


504F 23 


0087D 




INC 


HL 


...PLUS FOUR 


5050 CB77 


00860 




BIT 


6. A 


SEVBJTH KEYBOARD COLUMN 


5052 71 


00890 




LD 


(HL),C 


FIRST DISPLAY A "0" 


5053 2801 


00900 




JR 


Z.JUMP7 


DON'T CHANGE IF NO KEY 


5055 34 


00910 




INC 


IHL) 


MAKE IT A "1" IF A KEY 


5056 23 


00920 


JUMP7 


INC 


HL 


NEXT SCREEN LOCATION 


5057 23 


00930 




INC 


HL 


...PLUS TWO 


5058 23 


00940 




INC 


HL 


...PLUS THREE 


5059 23 


00950 




INC 


HL 


...PLUS FOUR 


505A C87F 


00960 




BIT 


7, A 


EIGHTH KEYBOARD COLUMN 


505C 71 


00970 




LD 


[HL),C 


FIRST DISPLAY A "0" 


5050 2801 


00980 




JR 


Z.JUMP8 


DON'T CHANGE IF NO KEY 


505F 34 


00990 




INC 


IHL) 


MAKE IT A "1" IF A KEY 


5060 05 


01000 


JUMPS 


PUSH 


DE 


SAVE THIS VALUE 


5061 00E1 


01010 




POP 


IX 


PUT IT IN IX FOR A BIT 


5063 D1 


01020 




POP 


DE 


GET ORIGINAL DE VALUE 


5064 19 


01030 




ADD 


HL.DE 


NOW START NEXT LINE 


5065 D5 


01040 




PUSH 


DE 


SAVE SAME VALUE AGAIN 


5066 D0E5 


01050 




PUSH 


IX 


STASH IT BRIEFLY 


5068 01 


01060 




POP 


DE 


AND BACK INTO DE INTACT 


5069 CB13 


01070 




HL 


E 


DEFINE NEXT KEYBRD ROW 


5U6B 10A6 


01080 
01090 




DJNZ 


LOOP 


DO IT FOR EIGHT ROWS 




01100 


; imiiinifiimiiiitiitiiiiii 


iitiiuitiiitmiiiiiitit 




01110 


; CLEAR 


UP POINTERS AND DELAY SO 


SCREEN DOES NOT JITTER 




01120 


; niiiiimiiiiiimiiiimiiii 


iiimiimiimi mum 




01130 


; 








506 D 01 


01140 




POP 


DE 


CLEAR THE STACK 


506E 010008 


01150 




LD 


BC.BOOH 


DELAY VALUE 


5071 CO6000 


01160 




CALL 


0060H 


DELAY SUBROUTINE IN ROM 


5074 188F 


01170 
011 BO 




JR 


START 


START THE ROUTINE AGAIN 




01190 


; mini. 


tllltllltlltltltllltlttll 


5000 


01200 




END 


ENTER 


BEGIN IT ALL HERE 


00000 TOTAL 


ERRORS 










31044 TEXT 


AREA BYTES LEFT 








ENTER 5000 


00250 


01200 








J0MP1 501A 


00440 


00420 








JUMP2 5024 


00520 


00500 








JUMPS 502E 


00600 


00580 








JUMP4 5038 


00680 


00660 








JUHP5 5042 


00760 


00740 








JUMP6 504C 


00840 


00820 








JUMP7 5056 


00920 


00900 








JUMPS 5060 


01000 


00980 








LOOP 5013 


00390 


010B0 








START 5005 


0D280 


0117D 








-* 


Chapt 


er 2 









from 3 to 2, resulting in values from 2C to 2F (, - 
. /). If a shift key was noted at 0437, the same 
toggle procedure is followed, changing values 30 
to 3B into 20 to 2B (these would become space ! 
"#$()• = etc.). 



042D 


C6 40 


ADD 


A, 40 


042F 


FE 3C 


CP 


3C 


0431 


38 02 


JR 


C.0435 


0433 


EE 10 


XOFl 


10 


0435 


CB 08 


HRC 


B 


0437 


30 12 


JR 


NC.044B 


0439 


EE 10 


XOR 


10 


043B 


18 OE 


JR 


044B 



Thus, the coding is complete: control codes (00 

to IF), punctuation (20 to 2F), numbers and 
figures (30 to 3F), upper case (40 to 5F) and lower 
case (60 to 7F). Just as an aside, the terms lower 
and upper case are sometimes written small and 
large case; old-time printers would chuckle at 
that. The case referred to is a printers case, 
which, when two were stacked one above the 
other, contained the capital and small letters. 
Thought you might like to know that. 

Back to the routine, starting at the termination 
sequence (044C); the decoded character is saved 
in D, and that is the only information we need to 
preserve, since the bulk of the work is done. 



044C 


01 AC OD 


LD 


BC , ODAC 


044F 


CD 60 00 


CALL 


006 


0452 


7A 


LD 


A,D 



A delay at 0060 is called, which was intended to 
wait through the bounce present with normal 
mechanical switch contacts - but the easily 
dirtied switches on the TRS-80 are abnormal! 
This delay uses the accumulator, and when it is 
free, the value in D is restored to it. This value is 
compared to 01 (the BREAK code), and returns 
directly to the main routine (0455) with any code 
other than BREAK. 

If BREAK is discovered, the program executes 
a call to 0028 (RST 28), returning to Level II. 

The routine is quite efficient, and is capable of 
returning 128 different values at a rate of better 
than 100 per second - ten times the speed of the 
world's fastest typist! 



Software Modifications 




Software Modifications 

Software makes the computer. With that in 
mind, it's not hard to understand the popularity 
of the TRS-80. Its BASIC is simple to use and 
immediately accessible. It reports back errors 
and provides clear screens and graphics with easy 
commands. At first, it was hard to imagine how 
such an elegant BASIC could be improved. 

Such illusions could not last long, especially 
when weakly designed hardware started to 
exhibit keybounce, when machine language 
software was so fast but so difficult to access, 
when putting a program aside meant losing all 
variables, and so forth. 

In this Chapter, several simple but very 
important software modifications will be 
presented : 

Keyboard debounce with repeating keys, 
audible beep tone, and an upper/lower case 
driver. 

Two methods of intercepting the BASIC 
interpreter in order to create your own 
commands. 

Packing machine language programs in 
simple BASIC strings, where they can be 
moved about and accessed easily. 

Sound and sound-effects generation 
routines. 

Creating somewhat unlistable BASIC 
programs. 



Auto-execution of SYSTEM programs, 
including an auto-load BASIC module. 

A simple machine language monitor 
accessible directly from BASIC. 

BASIC is not an incomprehensible, 
immutable, indivisible whole, but rather a pliant, 
carefully sewn, patchwork quilt of useful 
subroutines. These routines are accessed singly 
or as groups, not only whenever one of this 
BASIC'S English-language commands is entered, 
but even while waiting for commands to be 
entered or programs to be run. 

Chapter 1 contained an overview of the 
structures that BASIC is composed of; below is a 
more detailed look at the building blocks out of 
which Level II is created. 

1. A power-up sequence: including 
preparation of blocks of reserved memory, 
clearing of internal hardware systems, and 
total memory examination. 

2. Numeric conversion routines: single 
precision to integer and vice versa, numeric 
to string and vice versa, assignment of levels 
of precision. 

3. Simple arithmetic operations: addition, 
subtraction, multiplication, division, 
comparison, and raising to a power 
(exponentiation); integer, single, and 
double-precision calculations. 



The Custom TRS-80 



57 



Sophisticated Debouncing 



4. Mathematical functions: activities based 
on the sine function, as well as logrithms, 
square roots, absolute value and truncation, 
and random number generation. 

5. String operations: concatenation and 
truncation of strings, direct keyboard scan 
conversions (INKEY$), alphabetic 
comparisons. 

6. Variables: assignment of numeric, string, 
and array variable names, variable 
assignments (LET), updating of values, 
searching for variable names. Partly 
integrated with NEW routines. 

7. Keyboard input: polling of the keyboard 
matrix, conversion to characters, searching 
for carriage return, building a keyboard 
buffer. 

8. Cassette input/output: motor relay 
control, assembly of parallel data into serial 
form, timing of output pulses, timing of 
input, reassembly of data from serial to 
parallel form. 



Listing 3-1. Custom BASIC interpreter patch routine. 



4016 

4016 
3000 



06CC 
4036 
3801 
401A 
4099 
0060 



00100 
00110 
001 20 
00130 
00140 
00150 
00160 
00170 
001B0 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 
00290 



#############♦####♦###♦########♦########'#»**♦'»»♦*"»» 

DEB0UNCE, AUTO-REPEAT, AND BEEP KEYBOARD PATCH ROUTINE. 
THIS ROUTINE AS WRITTEN PATCHES INTO 4016. TO USE 
OTHER DRIVERS SUCH AS LOWERCASE, GRAPHICS, ETC., THE 
RETURN ADDRESS (NORMALLY 03E3) MUST BE REPLACED BY THE 
ADDRESS OF THE OTHER DRIVER. ALSO, TO USE THIS ROUTINE 
WITH THE CUSTOM INTERPRETER /ON AND /OUT COMMANDS BY 
PATCHING THIS DRIVER IN PLACE WITH /ON AND THE N0HMAL 
(OR UPPER/LOWER, ETC.] DRIVER IN PLACE WITH /OUT. 
#####*##»#########################*###*#»#»♦♦*»##'*'♦'♦ 



BASIC2 
KEYHLD 



00300 KEYBRD 
00310 HOLDER 



INKEYS 
DELAYS 



3000 
3001 



ES 

210B3 
3004 22164G 
3DD7 E1 
3006 C3CC06 



213640 
010138 
1600 
0A 



300B 
3D0E 
3011 
3013 

3014 5F 

3015 A3 

3016 2018 

3018 77 

3019 14 
301A 2C 
3018 CB01 
3010 79 



301E 
3020 



0680 

20F1 



D0320 

00330 

0D340 

00350 

00360 

0037D 

003B0 i 

00390 ENTREE 

0D4DD 

00410 

0D420 

00430 

0440 

00450 

00460 

00470 

00480 

00490 START 

00500 

00510 

00520 CHKKEY 

00530 

00540 

00550 

00560 

00570 INCD 

00580 

00590 

00600 

00610 

00620 

00630 

00640 



ORG 

DEFW 

ORG 



EO0 
EBU 

EO0 
EQO 
EO0 

EQU 



4016H 

ENTREE 

3000H 



06CCH 
4036H 
3801H 
401 AH 
4099H 
0D60H 



KEYBOARD SCAN PATCH 
START OF DEB0UNCE ROUT. 
NOTE THAT THIS UTILITY 
IS CURRENTLY SET UP FOR 
USE WITH A MEMORY ADD'N 
AT 3000H. IT CAN BE 
RE-0RGED AT ANY LOC'N. 
BASIC "READY" DISPLAY 
NORMAL KEYSTROKE STORE 
FIRST KEYBOARD ADDRESS 
RESERVED BYTE FOR DELAY 
INKEYt STORAGE BYTE 
ROM DELAY SUBROUTINE 



ittittitttiitiiimntttiimtiniitimtiiim iitttiiti 

ROUTINE BEGINS HERE, PATCHING ITSELF INTO PLACE AT 4016 

iiiiiiitntinniitiitiiiiitiiiinimiiiiiimniiiiti 



PUSH 
LO 
LD 
POP 

JP 



HL 

HL, START 

(4016H) ,HL 

HL 

BASIC2 



SAVE HL IF TRANSPARENT 
GET START OF ROUTINE 
PUT INTO KEYBOARD PATCH 

RESTORE HL VALUE 

AND 60 BACK TO "READY" 



iiiiiiitiiiitiiitititiimmitiiiiiiiiiiuiiitiiiiim 

THIS AREA MAKES THE PRELIMINARY CHECK OF KEYBOARD ROWS 

ii unit tiiiiti tit mil ttimiiiit mint ii mi ilium 



LO 

LO 

LD 

LD 

LD 

AND 

JR 

LD 

INC 

INC 

RLC 

LD 

SUB 

JR 



HL, KEYHLD 

BC, KEYBRD 

0,0 

A, [BO 

E,A 

E 

NZ.CKPREV 

(HL) ,A 

D 

L 

C 

A,C 

BOH 

NZ, CHKKEY 



SET UP STORAGE AREA 
SET UP FIRST KBD ROW 
SET UP COUNTER OF ROWS 
FIND IF A KEY PRESSED 
SAVE VALUE IN E REG. 
TEST IF KEY WAS PRESSED 
IF YES, SEE IF SAME ONE 
SAVE VALUE IN STORAGE 
INCREMENT ROW COUNTER 
INCREMENT STORAGE AREA 
SHIFT TO NEXT KBD ROW 
GET VALUE OF KBD ROW 
CHECK IF SHIFT KEY ROW 
IF NOT THEN CONTINUE 
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Listing Continued . . . 



9. Video input/output and display 
management: screen clear, scrolling, 
tabbing, character display including line 
feed, carriage return, backspace, set/reset, 
POS, POINT, cursor control, characters per 
line. 

10. Printer control: lines per page, top of 
form, output of characters, waiting for 
handshake. 

11. A command interpreter for organizing 
the entry points and order of chosen 
subroutines. 

12. Error reporting routines. 

13. Program line management routines. 
Partly integrated with NEW routines. 

14. Editing functions: Insert, delete, kill, 
exit, etc. Integrated in part with program 
line managment routines. 

15. Run-time management: Integrated with 
most of the above functions, but including 
subroutine handling, loop handling, etc. 

A more complete rundown on the TRS-80 
Level II ROM memory map can be found in 
Inside Level II, Supermap, Microsoft BASIC 
Decoded, and TRS-80 Disassembled Handbook 
(see Appendix II for details). 



Sophisticated Debouncing 

The first few hundred thousand TRS-80's 
were afflicted with serious keybounce problems - 
the appearance of double letters when only a 
single letter was typed. Full-scale preventive 
maintenance is presented in the following 
chapter; but there are software solutions as well. 
If debounce were the only criterion, though, 
maintenance would be the ideal solution. 

But the software designers made no provision 
for repeating keys, nor did the hardware 
designers include access to lower case characters. 
Furthermore, the silent keyboard remains a 
frustration to touch-typists and others who do 
not refer constantly to the screen for feedback. 

Thus, some sort of audible reinforcement (as 
with the Apple's entry-error beep) would be a 
thoughtful addition to the keying process. 

Listing 3-1 is a complete debounce, audible 
beep, key repeat, and upper/lower case driver 
routine. The program is written as three 
independent subroutines, each of which may be 
disabled or removed before assembly. 



Chapter 3 



Upper/Lower Case Driver 



Continued Listing 



3022 0607 

3024 2D 

3025 86 

3026 10FC 
3026 A7 
3029 3E00 
3028 CO 
302C 321A40 
302F C9 



3030 A6 

3031 2B1F 
3033 3A9940 

3036 A7 

3037 20E0 

3039 3A1A40 
303C 3C 
3030 321A40 

3040 FEFF 
3042 2809 



3044 CS 

3045 06FF 

3047 00 

3048 10FD 
304A C1 
304B 18CC 
304D 30 
304E 321A40 

3051 7B 

3052 73 



3053 C5 

3054 010002 
3057 CD6000 
305A C1 
305B 0A 
305C A3 
3050 C6 



305E 
305F 
3060 
3061 
3063 
3066 
3068 
3 06 9 
306B 
306C 
3060 
3 06F 
3070 
3072 
3073 
3075 
3077 
3078 
307A 
3 07B 
307C 
307D 



C5 

E5 

F5 

0640 

3A3D40 

E6F0 

67 

F602 

6F 

7D 

D3FF 

7C 

D3FF 

CS 

0640 

10FE 

C1 

10F2 

F1 

E1 

C1 

C3FB03 



BASIC2 

CHKKEY 

CKPREV 

DECA 

UECL 

DELAYS 

ENTREE 

hULUEH 

INCD 

INKEYS 

KtYBRD 

KEYHLD 

LOOP 

START 

STORE 

TKWSTE 



06CC 
3013 
3030 
3D4D 
3D24 
OOSO 
3LO0 
401A 
3019 
4099 
3BD1 
4036 
3D6C 
300B 
3052 
3047 



00650 
00660 
00670 
00680 
00690 
00700 
00710 
00720 
00730 
OQ7 40 
00750 
00760 
00770 
00780 
00790 
00800 
00810 
00820 
00830 
00840 
00B50 
OOB60 
00870 
08 BO 
00B90 
00900 
0091 
00920 
00930 
00940 
00950 
00960 
00970 
00980 
00990 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 
010B0 
01090 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
D1170 
01180 
01190 
01200 
01210 
01220 
01230 
01240 
01250 
01260 
01270 
012B0 
01290 
01300 
01310 
01320 
01330 
01340 
01350 
01360 
01370 
01380 
01390 
01400 
01410 
01420 
01430 
01440 
01450 
01460 
01470 
014B0 

00280 
0U520 
0OB20 
01030 
00690 
0U330 
00390 
00310 
00570 
00320 
00300 
002S0 
01330 
0U4S0 
01060 
00990 



CHECKING IS DONE - NOW SEE IF PREVIOUS KEYS HELD DOWN 
ttttlttllintmnimtllttltltttttltttltltttiltllltltl 

ELSE GET NUMBER OF ROWS 
HOVE BACK THRU STORAGE 
AND MAKE TOTAL OF KEYS 
AND 00 IT FOR ALL ROWS 
TEST IF ANY KEYS STORED 
A = 0, FLAGS REMAIN SAME 
BACK IF KEY IN STORAGE 
SAVE NEW VALUE IN CTR . 
AND BACK TO MAIN ROUT. 

n t n t it tin t tint mint mm in unit tin mint tin 

NEXT TEST IS FOR STATUS OF INKEYJ, IF IT IS IN USE 

it nut iiiitit tit tt tt ii tint niitii mi it tit iii iii it m 



LD 


B, / 


DEC 


L 


ADD 


A.IHL) 


DJNZ 


DECL 


AND 


A 


LD 


A,0 


RET 


NZ 


LD 


(HOLDER) 


RET 





AND 

JR 

LD 

AND 

JR 

LD 

INC 

LD 

CP 

JR 



IHL) 

Z, STORE 

A, (INKEYS] 

A 

NZ , INCD 

A, (HOLDER) 

A 

(HOLDER) ,A 

OFFH 

Z ,DECA 



SEE IF VALUE IS SAME 
STORE VALUE IF ZERO 
FIND VALUE AT INKEYJ 
SEE IF SOMETHING THERE 
IF SO THEN GO AWAY 
GET DELAY COUNTER VALUE 
INCREMENT THE COUNTER 
AND SAVE VALUE BACK 
IS COUNTER AT END YET? 
IF SO, THEN REPEAT 



nimttninitimmmmimiimmmmmtmit 

REPEATING-KEY TIME-WASTE VALUE (FF) HAY BE VARIED 

nit m tut tin ititi in 1 1 ii tin ii ill i n 1 1 ii ii ii mi tit i 



DECA 



STORE 



PUSH 

LD 

NOP 

OJNZ 

POP 

JH 

DEC 

LD 

LD 

LD 



BC 

6, OFFH 

THWSTE 

BC 

INCD 

A 

(HOLDER) , A 

A,E 

(HL) ,E 



SAVE BC FOR LATER 

GET DELAY VALUE 

WASTE SOHE TIHE 

AND DO IT FF TIHES 

RESTORE BC VALUE 

AND GO BACK TO SCANNING 

MAKE A BECOHE FE 

AND SAVE IT IN DELAY 

GET KEYSTROKE FOUND 

AND PUT IT IN STORAGE 



mt mitt tut it it nun in tut tit it tint nit tint tint 

DEBDUNCE BELOW HAY BE ELIHINATED BECAUSE BEEP USES TIHE 

tmiitintttnitttitttittitittittittttiitiitiiiiiiiiti 

SAVE VALUE IN BC 
GET DEBOUNCE DELAY 
AND CALL ROH DELAY 
AND GET VALUE TO BC 
GET VALUE AT KEYBOARD 
AND TEST IF IT'S THERE 
IF NOT IT WAS BOUNCE 

tint ttittttttitttititt tint ititi tttt it ii tttiiittiiittt 

BEEP ROUTINE PRODUCES VERY SOFT (NOT ANNOYING) SOUND 

n nnitiiiitiiiiitiiiiiitttinnitiitnmiiiiititttti 



PUSH 


BC 


LD 


BC.200H 


CALL 


DELAYS 


POP 


BC 


LD 


A,(BC) 


AND 


E 


RET 


Z 



POSH 

POSH 

PUSH 

LD 

LD 

AND 

LD 

OR 

LD 

LD 

OUT 

LD 

OUT 

PUSH 

LD 

DJNZ 

POP 

DJNZ 

POP 

POP 

POP 

JP 



BC 

HL 

AF 

B.40H 

A, [403DH1 

DFDH 

H,A 

2 

L,A 

A,L 

(OFFH) ,A 

A,H 

(OFFH) ,A 

BC 

B.40H 

$ + 

BC 

LOOP 

AF 

HL 

BC 

03FBH 



ELSE SAVE THE VALUE 
AND SAVE THE LOCATION 
AND SAVE THE KEYSTROKE 
AND KEY BEEP DURATION 
AND GET SCREEN STATUS 
AND HASK OUT ALL BITS 
SAVE WAVE "0" HASK IN H 
CREATE A WAVE "1" HASK 
SAVE WAVE "1" HASK IN L 
GET THE WAVE "1 " MASK 
AND CREATE WAVEFORM 1 
GET THE WAVE "0" MASK 
AND CREATE WAVEFORM 
SAVE THE DURATION VALUE 
GET THE PITCH VALUE 
AND WAIT THRU WAVEFORM 
RESTORE THE DURATION 
AND DO FOR FULL BEEP 
RESTORE KEYSTROKE VALUE 
RESTORE STORAGE VALUE 
RESTORE COUNTER VALUE 
AND RETURN TO KEYSCAN 



nnmmtmmmmmitmmimtmtnimmm 

END BASIC2 

00430 014B0 

00620 

00550 

00910 

UU710 

01140 

00220 

D0750 U0B70 OOB90 01040 

OUBbO 01020 

00640 

00500 

00490 

01410 

00400 

00830 

01000 



This routine patches into the keyboard control 
block driver address at 4016, leading the program 
to its own entry point instead of 03E3 (see the 
Supplement to Chapter 2 for details on the 
operation of the TRS keyboard scan). 

At START, the keyboard scan begins with HL 
pointing to the first position in a keystroke 
storage buffer (4036). BC points to the first 
keyboard row (3801). The program proceeds 
similarly to the normal Level II scan, except that 
a location (401A) has been set aside to 'count 
down' the time a key remains pressed. If any key 
or combination of keys remain pressed for the 
duration of the loop, the character (normally 
rejected by Level IPs rollover capabilities) is 
accepted again. This is the start of the repeating 
process. The INKEY$ storage area is checked 
(so that programs using INKEY$ are not delayed 
by an unusable character acceptance), and a 
short debounce-delay loop is entered. 

If a legitimate key is found, a different 
debounce-delay loop is entered, and a 
rapidly-fluctuating one-zero pattern is sent to 
the cassette port (FF). This sounds as a beep if 
an amplifier and speaker are connected. The 
routine can be exited before the beep, so only the 
debounce-repeat options are present; it can also 
be exited after the beep, returning to the main 
routine with the keystroke. 

The final portion of the program is an 
upper/lower case driver program. This driver is 
irrelevant unless you have a lower case 
modification in place, and should be disabled (or 
not assembled) if you have not made the 
modification. It merely strips the conversion to 
upper case normally made by the Level II 
software, and returns to the running program 
with the actual key depressed instead of an upper 
case converted version. 

Upper/Lower Case Driver 

When the TRS-80 keyboard is used, all 
characters are automatically converted to upper 
case before being displayed. The keyboard itself, 
however, returns a full upper/lower case value 
(albeit inverted - shift for lower case) to the 
display routine. The display routine then sends 
this information to the screen. The screen always 
displays upper case because the hardware to 
provide lower case was not a part of the TRS-80 
as sold. The addition of a single integrated 
circuit (see Chapter 4) provides this access. 

The lower-case driver patches into the display 
routine just as the character to be displayed is 
returned in the accumulator. Control is taken 
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7F00 



7F00 
7F03 
7F06 
7F09 
7F0C 
7F0D 
7F0F 
7F1D 
7F11 
7F13 
7F16 
7F1B 
7F1B 
7F1D 
7F1F 
7F21 
7F23 
7F25 
7F27 
7F29 
7F2B 
7F2D 
7F2F 
7F31 



DD6E03 

DDB6D4 

DA9AQ4 

0D7E05 

B7 

2B01 

77 

79 

FE20 

DA06D5 

FE80 

D2A604 

FE5B 

3008 

FE40 

38DE 

C620 

1B0A 

FE7B 

300B 

FE6 

3802 

0620 

C37D04 



401 E 

401 E 007F 



OSCC 

00000 TOTAL 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
270 
00280 
290 
00300 
00310 
00320 
00330 
00340 
00350 
3 6 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
00460 
00470 
00490 
00490 
00500 
00510 
00520 
00530 
ERRORS 



ititttiinnmiuittit ####♦♦###♦######*#! #####»#»♦#### 

SIMPLE LOWER-CASE DRIVER ROUTINE FOR BASIC AND DOS 



ORG 



07F00H 



NEAR TOP OF BASIC 



lltlltlllltlltl It IHItHttH1llllltllttl4l IHtlltllllir 

GET CONTROL BLOCK FOR SCREEN AND CHANGE CHARACTERS 

n>tnttttttnttntiftnmiititftmitititnntntnmit 



LD 
LD 
JP 
LD 
OR 
JR 
LD 
LD 
CP 
JP 
CP 

jp 

CP 
JR 
CP 
JR 

ADD 

JR 

CP 

JR 

CP 

JR 

SUB 

JP 



L, (IX+3) 

H,(IX+4] 

C.049AH 

A, [IX+5) 

A 

Z.GETCHR 

(HL) ,A 

A,C 

20H 

C.0506H 

80H 

NC.04A6H 

5BH 

NC.CHECK1 

40H 

C.GDAWAY 

A.20H 

GOAWAY 

7BH 

NC, GOAWAY 

60H 

C, GOAWAY 

20H 

047DH 



IX POINTS TO DEVICE 

CONTROL BLOCK [VIDEO] 
BACK TO SCREEN DRIVER 
GET CURSOR CHARACTER 
CHECK IF CURSOR IS ON 
GET ONE IF CURSOR OFF 
PUT CURSOR INTO POSN. 
GET CHARACTER TO SHOW 
SEE IF A CONTROL CODE 
BACK TO DRIVER IF C.C. 
SEE IF GRAPHIC CHAR. 
BACK TO DRIVER IF SO 
CHECK UPPER/LOWER CASE 
IF >5B, CHECK FURTHER 
CHECK UPPER CASE 
IF<40, CHECK NO FURTHER 
IF 40-5B, HAKE UPPER 
DONE - BACK TO DRIVER 
SEE IF ALPHABETIC 
NO FURTHER IF NOT ALPHA 
SEE IF ALPHABETIC 
NO FURTHER IF NOT ALPHA 
PLAY SWITCH TO LOWER 
OUT TO DRIVER NOW 



##♦######»########*###########*#####*#♦*##»####♦####### 

PUT VIDEO PATCH INTO PLACE UPON LOAD 

it Htuntttttiiumtmumuitmttnit tint) unit 



ORG 
DEFW 



401 EH 
LCDRIV 



; THIS IS VIDEO PATCH 
: PUT LCDRIV ROUTINE IN 



tttitttmtiiiimttitiiitniittittiniiiutmumin 

END 06CCH ; BACK TO BASIC READY 



Listing 3-13. Upper/lower case driver. 



Using The Editor/Assembler 

The Editor/ Assembler is one of the most 
powerful tools available to the TRS-80 
customizer. It is a fast, high-level compiler 
which produces a block of Z-80 machine code. 
Its job is to provide an easily accessible 
substitute for the tedious creation of bytes of 
Z-80 coded information. 

The Z-80 microprocessor is capable of 
responding to many hundreds of combinations 
of ones and zeros. Each pattern causes the 
Z-80 to follow a unique pattern of electronic 
activity, and many thousands of those activities 
in concert create a sophisticated language like 
BASIC. 

Using these patterns can be very tricky and 
time-consuming. Long ago, computer designers 
learned that it was easier to remember an 
action like 'load the accumulator with the 
contents of byte counter register' as 'Load A 
with B', abbreviated LD A,B. This is much 
handier than trying to recall 01111000. These 
abbreviations are called mnemonics, which are 
what you will find in all the program listings in 
this book. 

You will also find that, instead of specific 
locations in memory (such as 3C00), there may 



from the convert-to-upper-case display function 
in ROM. Ideally, this ROM routine could just be 
entered after its convert-to-upper case code; 
unfortunately, this would result in the famous 
inverted display . . . normal upper case, shifted 
lower case. 

To avoid this, the character is tested and 
converted to its proper case before being 
returned to the ongoing display driver routine in 
ROM. Notice something interesting: when 
programs are listed with this driver, the letters 
appear in lower case. That is because when the 

programs are entered, they are in fact being 
entered with the keyboard unshifted. Because 
this can be a bit disconcerting (and also quite 
illegible, since we all are used to upper case lists), 
an upper case on/off software patch is provided. 



be a 'label' (such as VIDEO). Once VIDEO has 
been defined as 3C00 to the Editor/ Assembler, 
it will always interpret the label as the number 
that was assigned to that label. 

Line numbers are provided to keep things in 
order and to insert or edit pieces of code, and 
there is space on every line for comments. 

Load the Editor/Assembler tape under the 
SYSTEM command. Its name is EDTASM. 
When the loading is complete, enter a slash (/), 
and you will be presented with the prompt: 

TRS-80 EDITOR/ASSEMBLER 1.1 

* 

This is EDTASM's equivalent of the BASIC 
prompt: 

RADIO SHACK LEVEL II BASIC 

READY 

>_ 

You are being asked for input. Unlike 
BASIC, EDTASM has only a few commands. 
They are (in the order you are likely to use 
them): 



This command inserts numbered program 
lines almost exactly like the BASIC command 
AUTO. When I is entered alone, numbering 
starts with line 100 in increments of 10 line 
numbers. On the other hand, 115,15 will start 
with line 15 in increments of 15. 
P 

The equivalent of a list. A single P lists the 
next sixteen lines of the program. P10:100 
lists 10 to 100. P# is the first line, P. is the 
current line, and P* is the last line. 

N 

Here is the renumber command. All lines are 
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automatically renumbered in increments of 10 
starting with line 100. Again, specific lines 
and increments may be specified: N300,50 
will renumber all lines in increments of 50, 
with the first line being 300. 

L 

Loads a source tape, but not an object tape. 
Up to a six-character name may be specified. 

W 

Writes a source tape (the program listing). Up 
to a six-character name may be specified. 

D 

Deletes the specified line or lines. D# deletes 
the first line, D. deletes the current line, and 
D* deletes the last line. Groups of lines are 
specified with a colon, as D40:170 or D#:90. 

E 

The edit function. The pound (#), period (.), 

and asterisk (*) represent the first, current, 

and last lines. A line number (as E400) may be 

specified.The editing functions are identical 

to BASIC'S editing functions - except that 

characters to be deleted are not deliniated by 

exclamation points. 

R 

Replaces the indicated line. The line number 

is presented, and new information may be 

entered. 

F 

This command finds a text string. It is not 
followed by a space. To search for the phrase 
'ENTRY', type FENTRY (ENTER). The 
entire line containing the phrase will be 
printed. To find the next identical phrase, 
merely type F (ENTER). 

H 

This sends the source listing, unassembled, to 
the printer. The complete source listing, 
including line numbers, is printed. As usual, 
(#), (.) and (*) may be used to indicate first, 
current, and last line, and groups of lines may 
be printed (as H55:3000). 

T 

The poor person's text editor. The source code 
is sent to the printer without line numbers. 
Thus, text may be entered a line at a time, and 
the numberless result printed. The same 
functions provided with H are available. 

B 

The exit to BASIC. As sold, EDTASM returns 
only to MEMORY SIZE?, and all programs 
and information, including EDTASM itself, 
are lost. Patches are available to re-route this 
exit. 



This command directs EDTASM to compile 
your source code into object code, make a list 
of all the labels (symbols) used, and check for 
errors. The A command may be followed by a 
six-letter name, as well as the 'switches' /NL 
(no listing), /NS (no symbol table), /NO (no 
object code), or /WE (wait upon error). The 
switches may be used in any combination, and 
are useful in shaking the errors out of an 
assembly program. 

Lines are always entered into EDTASM 
under the I (insert) or R (replace) commands. 
A line number is presented, so: 

0001 0*_ 

Several columns are then available, 
consisting respectively of an optional label, the 
mnemonic instruction, the 'operand' (if any), 
and any comments (always following a 
semicolon). A complete group of lines would 
look like this: 



00010 VIDEO EQU 3C00H 

00020 ORG 500DH 

00030 ENTRY LO A,B 

00040 LD HL, VIDEO 



[SCREEN TOP 
; START PROGRH 
;GET B INTO A 
;HL AT SCREEN 



This excerpt gives this information: the label 
VIDEO is an 'equate' (is defined as) location 
3C00. The program starts (has its origin - 
ORG) at 5000. The label ENTRY is assigned 
to the start of the program, and that program's 
first action is to load the accumulator with 
register B. Next, the HL register is pointed to 
VIDEO (3C00), the start of the screen memory. 

When told to assemble this (using the A 
command), the results will look like the 
following: 



3C00 


00010 


VIDEO 


EQU 


3C00H 


SCREEN TOP 


5000 


00020 




ORG 


5000H 


START PROGRH 


5000 7B 


00030 


ENTRY 


LD 


A,B 


GET B INTO A 


5001 21003C 


00040 




LD 


HL r VIDE0 


HL AT SCREEN 



The EDTASM program evaluated all the 
information in the source code and created the 
columns at the left. The first column specifies 
the current address, and the second column 
specifies the machine language code, if any, for 
that particular line. Note the correct 
assignment of 3C00 to VIDEO in line 00040. 78 
is the machine code for LD A,B and 21 is the 
machine code for LD HL.NNNN. In this case, 
NNNN is VIDEO is 3C00. 

For detailed instructions, refer to the 
EDTASM instruction manual. One thing to 
note: you can conserve source code memory 
space by using the right arrow (tab) instead of 
spacing between program lines, labels, 
commands, operands, and comments. Each tab 
is a single character, but spaces are counted 
separately. 
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0000 E3 

0001 7D 

0002 FE5B 
0004 2003 

0006 7C 

0007 FE1D 
0009 E3 
000A C27B1D 



0000 C0781D 

0010 F5 

0011 FEDO 
0013 2805 
0015 F1 
001S 2B 
0017 C3781D 



001A F1 

001B CD781D 

001 E 2003 
0020 C38719 



00 23 
0028 
0027 
0029 
002C 
002E 
0031 
0033 
0036 
0038 
003B 
003D 
0040 
0042 
0046 
0047 
004A 

004C 
004F 
51 
0054 
0056 
0058 



117B1D 

06 

FEAO 

CA0000 

FEBB 

CAOOOO 

FEA2 

CAOOOO 

FECC 

CAOOOO 

FECB 

CAOOOO 

FEEA 

CAOOOO 

FEA1 

CAOOOO 

FEAO 



CAOOOO 

FEA4 

CAOOOO 

FEA5 

CAOOOO 

C32000 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
003 20 
00330 
00340 
00350 
00360 
00370 
00380 
00380 
00400 
041 
00420 
00430 
00440 
00450 
00460 
00470 
00480 
00490 
00500 
00510 
00520 
00530 
00540 
00550 
00 56 
00570 
00580 
00680 
00600 
00810 
00820 
00630 
00840 
00650 
00860 
00870 
006B0 
00680 
00700 
00710 
00720 
00730 
00740 
0750 
00760 
00770 
007 60 
007 90 
00800 
00810 
00820 
00830 
00840 
00B50 
00860 
ODB70 



mimiimmimmmmmmmmmmmmm 

CUSTOM BASIC INTERPRETER PATCH FOR USE WITH ALL OF THE 
ROUTINES PRESENTED IN CUSTOM TRS-BO WHICH ARE TRANS- 
PARENT TO BASIC. THESE ROUTINES ARE'CALLED BY THIS 
ROUTINE, WHICH HAS ALREADY PLACED A RETURN VALUE ON THE 
STACK. ALL TRANSPARENT ROUTINES MUST EXECUTE A RETURN 
INSTRUCTION AS THEIR FINAL INSTRUCTION TO WORK WITH 
THIS CUSTOM INTERPRETER ROUTINE. THE COMMANDS AVAIL- 
ABLE WITH THIS INTERPETER ARE: 

/LOAD /SAVE /NEW /OPEN 

/ON /OFF /GET /PUT 

/STEP /MEM 
AND OTHER USER-DEFINED "/" COHMANDS AND ROUTINES. 
THIS ROUTINE HAS PUSHED THE RETURN ADDRESS I1D7B) ON 
THE STACK. THE ROUTINE JUMPED TO IS A PSEUDO-CALL 
IN THAT IT EXECUTES A "RET", THUS RETURNING TO 1D78. 

iftimmmnm,mmmmmmmtmmmmit 



EQU 



1D76H 



iROM READ KEYS & T0KENI2E 



itiimmimtimmmmmmmmmiftttimm 

CHECK THAT THE BASIC STACK IS IN INTERPRETATION MODE 
iimmmimimmmmmmmmmmmmm 



EX 
LD 
CP 

JR 

LD 

CP 
EX 
JP 



(SP) ,HL 

A,L 

5BH 

NZ.NOTRDY 

A,H 

1DH 

[SP] ,HL 

NZ.BYTE 



GET SP INTO HL FOR TEST 
GET L INTO A FOR TEST 
IS LSB OF STACK 5B? 
NOT INTERPRETING IF NZ 
GET H INTO A FOR TEST 
IS MSB OF STACK 1D? 
RESTORE STACK TO SP 
IF NOT 1DH THEN TO ROM 



it i m mmmmmmummimmmmimmm 

MUST HAVE BEEN AT 105B FOR INTERPRETATION; THEREFORE, 
CHECK TO SEE IF SPECIAL SLASH [/) COMMAND THAT IS NEXT 

iimmmmimmimmimmmmmimmmi 



READ CHAR. & TOKENIZE 
SAVE VALUE READ 
IS IT "/" COMMAND? 
IF SO, THEN CONTINUE 
ELSE RESTORE AF VALUE 
PUT POINTER BACK ONE 
AND BACK TO NORMAL ROM 



mmmmmmmmmmmmummmimmi 

SLASH (/] HAS BEEN FOUND, THEREFORE MUST BE COMMAND 
ttmmimmmmmmmmummmmtmm, 



CALL 


BYTE 


PUSH 


AF 


CP 


ODOH 


JR 


Z,0KSLSH 


POP 


AF 


DEC 


HL 


JP 


1D78H 



OKSLSH POP 
CALL 
JR 

SYNERR JP 



AF 

BYTE 
NZ.SAVE 
1887H 



RESTORE VALUE TO AF 
NEXT COMMAND IN LINE 
GO IF ONE IS IN PLACE 
7SN ERROR IF LINE END 



0000 
00010 



08 90 

008 80 
00900 
0091 
00920 
00930 
00940 
00950 
00960 
00970 

009 80 
00990 
01000 
01010 
01020 
01030 

TOTAL ERRORS 



mmmmmmmiimmmmmmmmimmi 

SINCE SLASH & NEXT CHARACTER HAS BEEN FOUND, NOW NEXT 
CHARACTER IN LINE MUST BE TESTED FOR VALIDITY AS USER- 
DEFINED COMMAND. SEE ABOVE FOR THOSE AVAILABLE HERE. 

tummmmmmmmmimmmimmmmii 

GET RETURN AODRESS 
PLACE IT ON STACK 

SAVE 

GO TO SAVE ROUTINE 

NEW 

SO TO RENEW ROUTINE 

OPEN 

GO TO OPEN ROUTINE 

STEP 

GO TO STEPPING ROUTINE 

MEM 

GO TO MEMORY SET ROUT. 

LOC 

GO TO RELOCATION ROUT. 

ON 

GO TO DE80UNCE ON ROUT. 

OUT 

KILL DEBOUNCE ROUTINE 
GET 

GO TO READ TAPE ROUTINE 

PUT 

GO TO WRITE TAPE ROUT. 
?SN ERROR IF UNDEFINED 

mmmmmiimmmmimmmmmmmmi 

THIS ROUTINE WILL NOT ASSEMBLE AS IT STANDS. IT MUST 
BE APPENDED TO THE OTHER ROUTINES WHICH WILL BE USED 
IN CONJUNCTION WITH BASIC. ALL THE TERMS LISTED ABOVE 
MUST BE DEFINED, OR ELSE THEY MUST BE DELETED FROM THE 
ASSEMBLY LISTING. 

mmmmimmmmmmmmmmmmmm 

ENO 



LD 


DE,1D78H 


PUSH 


DE 


CP 


OADH 


JP 


Z, SAVER 


CP 


OBBH 


JP 


Z, RENEW 


CP 


0A2H 


JP 


Z, OPENER 


CP 


OCCH 


JP 


Z.STPSET 


CP 


OC8H 


JP 


Z.MEHSET 


CP 


OEAH 


JP 


Z.RELOC 


CP 


OA1H 


JP 


Z.KEYON 


CP 


OAOH 


JP 


Z.KEYOFF 


CP 


OA4H 


JP 


Z.COPYIN 


CP 


0A5H 


JP 


Z.DUBBER 


JP 


SYNERR 



Patching the BASIC Interpreter 

Each time a BASIC command is entered or a 
program line is being run, a section of ROM 
evaluates each of these commands in order, 
jumping to internal subroutines that will 
produce the desired result. This section of ROM 
is called the interpreter, an area which translates 
the commands into program action. 

At address 4003, the machine language 
instruction C3 78 ID can be found, which means 
'jump to address 1D78'. 1D78 is the main entry 
point to the BASIC interpreter. But the routine 
can be intercepted before going to 1D78, by 
patching a different jump into addresses 4004 
and 4005. 

This intercept is very important, because <>very 
BASIC - transparent software modification in 
this book will be patched into this location, 
leading to the master custom interpreter 
program below (Listing 3-2). When a command 
line is entered, the program in Listing 3-2 
intercepts the routine at 4003, and first examines 
the status of the stack pointer; if it points to 
1D5B, then the intercept program knows BASIC 
is in the interpretation mode. 

Its next step is to CALL 1D78. By calling 1D78 
instead of jumping to it, a 'tokenized' version of 
the next command in line is returned to the 
master custom interpreter. Tokenizing is an 
important, specialized process which allows the 
BASIC listings to use very little memory and 
allows the interpreter to evaluate commands at 
high speed. 

When the token is returned to the custom 
interpreter, it can then be evaluated to see if it is 
a specially designated indicator command. 

If the slash command indicator is found by the 
custom interpreter, it moves on to a lookup table 
to search for one of the specialized commands. 
All these commands will be tokens as well, so only 
a single byte comparison need be made. 

There is another method of patching into the 
BASIC interpreter. If you are a Level II user, 
merely enter the command OPEN. Very 
promptly the computer will respond with '?L3 
ERROR'. What is an '?L3 ERROR'? It refers to 
a 'Level III Error', the extended BASIC that is 
available as a part of the TRS-80 disk system. 

Now enter the statement OPNE. This time a 
'?SN ERROR' is produced. How does the 
machine know that OPEN is a disk command 
and that OPNE is just garbage? 
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4098 
4030 
401A 
4019 



4016 

4016 3930 
401 E 
401 E 2A31 



3039 



3039 213640 
303C 01 01 38 
303F 1600 



3041 0A 

3042 5F 

3043 A3 

3044 201 B 
3046 77 



3047 14 

3048 2C 

3049 CB01 
3048 78 



304C D680 
304E 20F1 



3050 0607 

3052 2D 

3053 86 

3054 10FC 

3056 A7 

3057 3E00 
3059 CO 



305A 321A40 
3050 C9 



305E A6 
305F 2B1E 
3061 3A9940 

3064 A7 

3065 20E0 
3067 3A1A40 
306A 3C 



00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

0D1B0 

00190 

00200 

00210 

00220 

00230 

00240 

00250 INKEYS EQU 

00260 POHTFF EOU 

00270 KPLACE EQU 

00280 SHIFTH E0U 



mtimmmtimmimmmmmttmimtmim 

FULL-FEATURED KEY/SCREEN DRIVER - DENNIS BATHORY KITSZ 
THIS ROUTINE IS A LEVEL II KEYBOARD REPLACEMENT ROUTINE 
CAPABLE OF PROVIDING: AUTOREPEAT AFTER SELECTED DELAY 
(FOUND IN B REGISTER IN DELAY SECTION); BEEP WITH ANY 
CHOICE OF PITCH; RESULTANT DEBOUNCE; COHRECTED SHIFT- 
DOWN ARROW CONTROL CODE FOR EARLIER LEVEL II ROMS; A 
SHIFT-0 SELECTABLE UPPER/LOWER CASE DRIVER AND DISPLAY. 
NOTE THAT THIS ROUTINE IS SET UP FOR USE AT 3039 HEX 
(12345 DECIMAL! FOR ENTRY IN THE MEMORY SIDECAR WHICH 
IS ADDRESSED FROM 3000 TO 37D0 HEX. IT MAY BE SET TO 
ANY ORIGIN OF THE USER'S CHOICE, SUCH AS USUAL HIGH HEM 
timmmmmmmmimmmtmmmmmm 



4099H ;INKEY* BYTE STORAGE AREA 

403DH ; CASSETTE OUTPUT PORT 

401AH ;1-BYTE KEYSTROKE STORE 

401SH ;STORAGE FOR LC DRIVER 



00290 ; 

mmmtmmtmmmmmmmmmtmmmi 

PATCH KEYBOARD ROUTINE INTO 4016 AND DISPLAY INTO 401 E 
imitmimlmmmmmmmmmmttm tutu 



00300 

00310 

00320 

00330 

00340 

00350 

00360 

00370 

00380 

00390 

00400 

00410 

00420 

00430 

00440 ; 

00450 KBPFIX 

00460 

00470 

00480 ; 

00430 

00500 

00510 

00520 ; 

00530 KEYPRS 

00540 

00550 

00560 

00570 

00580 ; 

00590 

00600 

00610 

00620 ; 

00630 RECHEK 

00640 

00650 

00660 

00670 ; 

006 BO 

00690 

00700 

00710 

00720 

00730 

00740 

00750 

00760 

00770 

00780 ; 

00790 

00800 CLRMEM 

00810 

00820 

00830 

00840 

00850 

00860 ; 

00870 

00880 

00890 

00900 

00910 

00920 

00930 

00940 

00950 

00960 

00870 ; 

00880 STROKE 

00990 

01000 

01010 

01020 

01030 

01040 



ORG 
DEFW 
ORG 
DEFW 

ORG 



401 6H 
KBPFIX 
401 EH 
LOWER 

3039H 



START OF KEYBOARD SCAN 
PATCH KEYBOARD ROUTINE 
START OF DISPLAY SWEEP 
PATCH UPPR/LOWR ROUTINE 

START AT MEMORY SIDECAR 



ttlttttttttttttlttttttttilllittttttnttltttttttlttlltlt 

SET STORAGE #1 , ROW #1 , COUNTER #0 PARAMETERS FOR SCAN 
tttttttttttttttttttttlttttttttttttttttltttttttttttttttt 



LD 
LD 
LO 



HL.4036H 
BC.3801H 
0,0 



STORAGE FOR KEYSTROKE 
FIRST ROW OF KEYS 

COUNTER FOR COLUMS 



mmmmmmtmiimmmmmmmmmtm 

CHECK EACH ROW OF KEYS IN SEARCH OF ONE THAT IS PRESSED 

mimmmmmmmmimmmmmmmmti 



LO 
LD 
AND 

JR 
LD 



A.IBC) 

E,A 

E 

NZ, STROKE 

IHL] ,A 



RETRIEVE ROW CONTENTS 
SAVE IT TEMPORARILY 
SET FLAGS FOR TEST 
NOT ZERO IF KEY PRESSED 
SAVE CURRENT VALUE 



immmiitmmmmmimttmmmmmmm 

INCREMENT AND ROTATE PATTERN CHECKS EACH ROW IN TURN 
III mimmillimtll till llll til lllm til «***##*#**## 



INC 
INC 

RLC 
LD 



D 
L 
C 
A,C 



; INCREMENT ROW COUNTER 

; INCREMENT STORAGE AREA 

; GET NEXT KEYBRO COLUMN 

; GET VALUE INTO ACCUM. 



mimmimmmmimmmmmmmmmim 

CHECK IF LAST VALID ROW (I.E., NOT INCLUDING SHIFT KEY) 

iiiimiiiiimiimiiiitimmttmimmimmim 



SUB 
JR 



BOH 

NZ, KEYPRS 



LAST ROW IS 3B80 HEX 
NEXT CHECK IF NOT DONE 



mmtmmmimimmmmmmtmmmmm 

AUTOREPEAT STATUS TEST ... CHECK IF KEYBOARD IS CLEAR 

•ttitmmimtimtmiiimtiimitmnmtntniit 



LD 

DEC 

ADD 

DJNZ 

AND 

LD 

RET 



B,7 

L 

A,(HL) 

CLRMEM 

A 

A,0 

NZ 



COUNTER OF KBRD ROWS 
START COUNTING BACK 
AND ADO IT UP IN ACCUM 
AND DO IT FOR 7 ROWS 
TEST FOR ANY KEY DOWN 
A=0, FLAGS ARE INTACT 
BACK IF KEYS IN USE 



iiitttiiiitnimiiimitiittitiiitmmitttimitim 

RESET AUTOREPEAT DELAY TO ZERO IF THE KEYBOARD IS CLEAR 

immmmmmtmmimtmmmmmmmm 



LD 
RET 



[KPLACE), A 



; ELSE DELAY GETS RESET 
; AND GO BACK ANYWAY 



it mimmm tmimtm m ii mimii limit mint 

IF KEYSTROKE IS FOUND, CHECK STATUS OF AUTOREPEAT LOOP 

mimmimmmmmmtimmmmmmmm 



AND (HL) ; CHECK KEYSTROKE STORAGE 

JR Z, FOUND ; NEW KEY IF NOT SAME 

LD A, (INKEYS) ; CHECK STATUS OF INKEY$ 

AND A ; TEST IF SOMETHING THERE 

JR NZ, RECHEK ; IF THERE IS, LOOP BACK 

LD A, (KPLACE) ; NOW CHECK SPECIAL STORE 

INC A ; LET STORE = STORE + 1 

Listing Continued . . . 



It is in this distinction that the other patch can 
be made into the BASIC interpreter. All the 
DOS (disk operating system) commands already 
exist in Level II BASIC! A patch point 
(sometimes called a 'vector', other times a 'hook') 
is provided for each of these commands in RAM. 
When the disk system is added to the TRS-80, 
each of these patch points is filled with a jump to 
a DOS parameter. 

Table 3-(?) presents a list of the DOS 
commands and their patch points in RAM. If you 
are not (and do not plan to be) a disk user, and if 
your programs will not be sold to potential disk 
users, then these patch points are for you. Each 
one can be used for your own set of commands, 
and every one will be accepted by a running 
BASIC program. 

List of DOS Pstch Points 

DOS REPLACEMENT REPLACEMENT 

COMMAND PATCH POINTS (HEX) PATCH POINTS [DECIMAL) 



CVI 


4153 


- 4154 


1C723 


- 16724 


FN 


4156 


- 4157 


16726 


- 16727 


CVS 


4158 


- 415A 


16729 


- 16730 


DEF 


41 5C 


- 41 5D 


16732 


- 16733 


CVD 


41 5F 


- 4160 


16735 


- 16736 


EOF 


4162 


- 4163 


16738 


- 16738 


LDC 


4165 


- 4166 


16741 


- 16742 


LDF 


4168 


- 4169 


16744 


- 16745 


HKII 


41 6B 


- 41 6C 


16747 


- 16748 


HKSI 


41 6E 


- 41 6F 


16750 


- 16751 


MKDI 


4171 


- 4172 


16753 


- 16754 


CHD 


4174 


- 4175 


16756 


- 16757 


TIME* 


4177 


- 4178 


16758 


- 16760 


OPEN 


41 7A 


- 41 7B 


16762 


- 16763 


FIELD 


41 7D 


- 41 7E 


16765 


- 16766 


GET 


4180 


- 4181 


16768 


- 16769 


PUT 


4183 


- 4184 


16771 


- 16772 


CLOSE 


4186 


- 4187 


16774 


- 16775 


LOAD 


41 BB 


- 41 8A 


16777 


- 16778 


MERGE 


41 8C 


- 41 8D 


16780 


- 16781 


NAME 


41 8F 


- 4190 


167B3 


- 16784 


KILL 


4182 


- 4193 


16786 


- 16787 


Si 


4195 


- 4186 


16789 


- 16790 


LSET 


4198 


- 4188 


16792 


- 16793 


RSET 


41 9B 


- 41 8C 


16796 


- 16796 


INSTR 


41 9E 


- 41 8F 


16798 


- 1679) 


SAVE 


41 A1 


- 41 A2 


16801 


- 1B802 


LINE 


41 A4 


- 41 A5 


16804 


- 16805 



Creating BASIC Tokens 

Here's a program to start this discussion: 

10 CLS : REH XXXXXXXXXXXXX 

20 Y = 15360 

30 FOR X = 17129 TO 17300 

40 POKE Y, PEEK (X) 

50 Y = Y + 1 : NEXT X 

60 PRINT "END OF PROGRAM" 

70 PRINT "LIST OF PROGRAM" 

80 LIST : REM ZZZZZZZZZZZZ 

On the screen you now have two versions of 
the identical information - the BASIC 
program. The lines of X's and Z's are there to 
help you locate the program amidst some of 
what looks like garbage. You will also see that 
there are some familiar elements missing: the 
line numbers (which have been converted to 
hexadecimal), and all the BASIC commands 
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Continued Listing 

306B 321A40 01050 
306E FEFF 



3070 2808 

3072 C5 

3073 06FF 
3075 10FE 

3077 C1 

3078 18CD 
307A 30 
3078 321A40 



307E 7B 
307F 73 

3080 7A 

3081 07 
3 OSS 07 

3083 07 

3084 57 



3085 0EO1 

3087 79 

3088 A3 
3088 2005 
3088 14 
308C CB01 
308E 18F7 



3090 3A8038 
3083 47 

3094 7A 

3095 CB40 
3097 FE60 
309S 3016 
309B 57 



309C 3A4038 
30BF E610 
30A1 2009 
30A3 7A 
30A4 CBOB 
30AB 3830 



30AB C620 
30AA 183B 
30AC 7A 
3QAD D640 
30AF 1B34 
30B1 0670 
3083 3010 
30B5 C640 
30B7 FE3C 
30B9 3802 
30BB EE10 
30B0 CB08 
30BF 3024 
30C1 EE10 
30C3 1820 
30C5 07 
30C6 CBOB 
30C8 3001 
30CA 3C 
30C8 210530 
30CE 4F 
30CF 0600 
30D1 09 

3002 7E 

3003 1810 



01060 

01070 

01080 

01090 

01100 TMWSTE 

01110 

01120 

01130 OECA 

01140 

01150 

01160 

01170 

01 180 

01190 

01200 

01210 ; 

01220 

01230 FOUND 

01240 

01250 

01260 

01270 

012B0 

01290 ; 

01300 

01310 

01320 

01330 ; 

01340 

01350 BACKUP 

01360 

01370 

013B0 

01390 

01400 

01410 ; 

01420 

01430 

01440 

01450 

01460 AROUND 

01470 

01480 

01490 

01500 

01510 

01520 

01530 

01540 

01550 

01560 

01570 

01580 

01590 

01SOO 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01E80 

01690 

01700 

01710 CNTROL 

01720 

01730 

01740 20429H 

01750 

01760 

01770 

01780 

01790 

01800 Z0435H 

01810 

01820 

01830 

01840 Z043DH 

01850 

01860 

01870 

01880 Z0443H 

01890 

01900 

01910 

01920 

01930 

01940 ; 

01950 

01960 

01870 

01980 

01890 



LO (KPLACE).A ; AND PUT IT BACK THEHE 

CP OFFH ; CHECK IF IT IS AT END 

JB Z.DECA ; IF SO, THEN HOLD THERE 

PUSH BC ; SAVE ROW COUNTER REG. 

LO B.OFFH ; GET DELAY VALUE INTO B 

DJNZ TMWSTE ; AND DELAY JUST A BIT 

POP BC ; AND RESTORE ROW COUNTER 

JR RECHEK j AND BACK TO CHECK NEXT 

DEC A ; LET A = A - 1 (STORAGE) 

LD IKPLACE),A j AND PUT IT IN STORAGE 



tHH*tHMtttttttimtt»itUH**UHt*HtHtHHtHHIIt 

GET KEYBOARD BYTE BACK, STORE AND PREPARE TO MANIPULATE 

immmmmummmmmimtimmmmmt 

FIRST CONVERT D FROM COUNTER TO PSEUDO ASCII EOUIVALENT 
tttltUttttlltHH1lltllllHHHHUIHIlHltHHtltltl 



LD 
LD 
LD 

RLCA 
RLCA 
RLCA 
LD 



A.E 

[HL], 
A.D 



D.A 



GET KEYBOARD BYTE BACK 
STORE IT IN STROKE AREA 
GET ROW COUNTER FROM D 
AND BEGIN A PROCESS... 
...OF CONVERTING IT... 
...TO AN OFFSET VALUE. 
AND PUT IT BACK IN D 



tmmmmtimmimimimmtmtiimmmm 

NOW PREPARE ROW COUNTER C TO COMPLETE ASCII CONVERSION 

iimtmitiimmmimmtmmmmmmiimii 



LD C,1 ; GET NUMBER ONE READY 

LO A,C ; ACCUM. HAS C FOR HATH 

ANO E ; TEST IF C = KEYSTROKE 

JR NZ, AROUND ; IF NOT, THEN GO AROUND 

INC D ; ELSE D = ROW + COLUMN 

RLC C ; C SET TO NEXT COLUMN 

JR BACKUP ; GO BACK AND TEST AGAIN 



mmmimimmtmimimitmtmimtmttmt 

SHIFT ROW IS TESTED TO DETERMINE UPPER/LOWER STATUS 
mmmimtiiitmmitttititmmtmmtiuimti 



LD 

LD 

LD 

ADD 

CP 

JR 

LD 



A.I3880H) 

B,A 

A,D 

A.40H 

60H 

NC.Z0429H 

D.A 



GET SHIFT ROW FOR TEST 
AND SAVE IT IN 8 
GET ROW COUNTER BACK 
AND CONVERT TO ASCII 
IS IT UP/LW/GRAFIX/ETC 
GO OUT IF GRAPHICS MODE 

SAVE PARTLY CONVERTED 



n mm imtnmmmmmmt minimum mm 

SHIFT/DOWN ARROW CHECKED FOR CONVERSION TO CONTROL CODE 

itimit tm tit ttt mi iii mmmmtmt m tmmtit 



LD 

AND 

JR 

LD 

RHC 

JR 



A,(3B40H) 

10H 

NZ, CNTROL 

A,0 

8 

C.GOAWAY 



GET VALUE FOUND 7TH ROW 
CHECK IF DOWN ARROW 
IF SO, PRODUCE CONTROL 
ELSE GET VALUE BACK 
B BUMPS INTO CARRY FLAG 
IF CARRY, THEN SHIFT 



iittmittniiiitmiittiimimtmmmmmmm 

LOWER CASE CONVERSION, MASK STRIPPING, FINAL TOUCHES 

imnmtimttmmmmtmmtmmmtmmm 



ADD 

JR 

LD 

SUB 

JR 

SUB 

JR 

ADD 

CP 

JR 

XUH 

ARC 

JR 

XOH 

JR 

RLCA 

RRC 

JR 

INC 

LD 

LD 

LD 

ADD 

LD 

JR 



A.20H 

GOAWAY 

A,D 

40H 

GOAWAY 

70H 

NC,Z043DH 

A.40H 

3CH 

C.Z0435H 

10H 

B 

NC, GOAWAY 

10H 

GOAWAY 

8 

NC.Z0443H 

A 

HL, TABLET 

C,A 

B,0 

HL.BC 

A.IHLJ 

GOAWAY 



IF NOT THEN LOWER CASE 
AND GET OUT OF ROUTINE 
IF CONTROL CODE, GET IT 
GET RID OF ASCII MASK 
AND GET OUT OF ROUTINE 
THE BALANCE OF THE 

ROUTINE BELOW UP TO 
THE BEEP SECTION IS 
VIRTUALLY IDENTICAL 
TO THE KEYBOARD 

DETERMINATION SUB- 
ROUTINE FOUND IN 
ROM. A COMPLETE 
DESCRIPTION OF THIS 
SECTION OF THE KEY- 
BOARD SCAN IS FOUND 
IN THE CHAPTER 
SUPPLEMENT ON THE 
ROM KEYBOARD SCAN. 
THIS TABLE IS CHANGED 
FROM THE ONE FOUND 
IN EARLIER ROMS, BUT 
THE ROUTINE USED TO 
ACCESS IT IS THE 
SAME. 



tttntmmmtmtttmmmmmmmmntmtn 

TABLE BELOW DETERMINES TRS-BO [NOT ASCII) CONTROL CODES 
SEE SUPPLEMENT ON KEYBOARD SCAN FOR DETAILS ON CODES 

nmimtimiimitmimiimmmmtimmimi 



(CLS, FOR, TO, POKE, PEEK, NEXT, 
PRINT, and LIST). What has happened to 
them? 

For two purposes - economy of memory and 
speed of execution - legitimate BASIC 
commands are converted to single -byte keys 
called 'tokens'. When you enter a BASIC 
command line, a subroutine evaluates each 
character group in that line, searching through 
all the keywords in ROM until it finds a match. 
When it finds a match, it replaces the original 
group of characters (PRINT, for example, 
which is five characters) with a single byte (178 
in this case). Four bytes are saved, and the 
lengthy process of looking up the word PRINT 
is eliminated at run time. 

Evaluating for tokens is indeed a 
time-consuming process. If you type 255 
characters of garbage and press (ENTER), the 
computer will spend nearly two seconds 
attempting to tokenize that line before 
reporting a ?SN ERROR. A line which uses 
the command CHR$() very often also takes 
time to tokenize. You can imagine the speed 
difference if this process were left to be done at 
RUN time. 

The presence of tokens in a complicated 
program can make the difference between a 
running program and an ?OM ERROR. As an 
experiment, return to MEMORY SIZE? and 
respond with 17250. This gives you about 50 
bytes of program space (at least 83 are needed 
to run any program). Enter these lines: 

10 PRINT"THIS IS A TEST TO FIND OUT" 

20 PRINT'HOW MUCH MEMORY SPACE IS IN HERE" 

In attempting to run this program, you will 
get an ?OM ERROR. Now remove the word 
'IN' and one space from the second line. The 
program will run fine. Finally, insert PRINT: 
on line 10. In spite of the fact that it looks like 
you have inserted 6 new characters 
(P-R-I-N-T-:), you have really only inserted 
two - the PRINT token (178) and a colon. 

There is a lesson in this. If your program is 
running quite close to the end of your system's 
available memory, try cutting down the lines of 
text within the program. Many more BASIC 
commands will then open up for use. 

Another interesting trick opens up. You may 
have a BASIC program which you would like to 
convert for use on a printer. This can take up 
quite a bit of time. As a quick fix, you might 
just leaf through your program, replacing all 
PRINTs with LPRINTs. This won't work 
every time (I'll explain later), but it's a useful 
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Creating BASIC Tokens 



Continued Listing 



30D5 0D00 


02000 


TABLET 


OEFW 


ODOOH 


; CARR. RET. / CARR. RET. 


30D7 1F1F 


02010 




DEFW 


1F1FH 


; CLEAR SCAN / CLEAR SCRN 


3009 0101 


02020 




DEFW 


0101H 


; BREAK KEY / BREAK KEY 


30DB 5B1B 


02030 




DEFW 


1B5BH 


; EDIT ESCAPE / UP ARROW 


3000 0A00 


02040 




DEFW 


OOOAH 


; NOP ICHANGE) / LINEFEED 


30DF 0618 


02050 




DEFW 


1B08H 


; BACKSP. LINE / BACKSP. 


30E1 0919 


02060 




OEFW 


1808H 


; 32-CKAH MODE / HOR. TAB 


30E3 £020 


02070 
02080 




DEFW 


2020H 


; SPACE / SPACE 




02090 


j <>i'i,,,,,in,itit,iu,i,,,,iuiti,,,,,,,,,,,,iit,,iiu 




02100 


; FINAL 


VALUE 


IS SAVED IN 0; STATUS OF SHIFT-0 TESTED 




02110 
02120 


; "HIlmHtUtlHIttlUlliltiMHtHHIimHltHHU 


30 E5 57 


02130 


GOAWAY 


LD 


D.A 


; SAVE VALUE IN D REG. 


30E6 3A103B 


02140 


BEEEEP 


LD 


A, [381 OH) 


; GET KEYBOARD ROW 


30E8 FE01 


02150 




CP 


1 


; SEE IF IT IS ZERO (0) 


30EB 2016 


02160 




JB 


NZ, BLEEEP 


; GO OUT IF NOT ZERO 


30E0 3A803B 


02170 




LD 


A.OBBOH) 


; IF 0, CHECK SHIFT ROW 


30F0 FE01 


021 BO 




CP 


1 


; CHECK IF SHIFT KEY 


30F2 2O0F 


02190 




JR 


NZ, BLEEEP 


; IF NOT GO OUT TO BEEP 


30F4 3A1940 


02200 




LD 


A,[SHIFTR) 


; ELSE GET SHIFTLOCK 


30F7 EE01 


02210 




XOR 


1 


; AND SWITCH 1-0 OR 0-1 


30F9 321940 


02220 




LD 


(SHIFTRJ.A 


; AND PUT IN SHIFTLOCK 


30FC 010005 


02230 




LD 


BC.500H 


; GET LONGER DELAY 


30FF C06000 


02240 




CALL 


0060H 


; CALL ROM DELAY SUBR. 


3102 C9 


02250 
02260 




RET 




; AND GO BACK, NO BEEP 




02270 


; >i,,i,,i,tiit,tiiti,t,ttiiitiii,iiii,,,,,,intti,,,i,,i 




02280 


; DEB OUNCE IS 


ADDED; ALTERNATE: BEEP MAY BE LENGTHENED 




02290 


: ii'iit,iit,nt,,,ttiiit,t,i,ii,i,,,,,t,,,,,i,iitttinit 




02300 


; 








3103 018001 


02310 


BLEEEP 


LD 


BC.1B0H 


i DEBOUNCE VALUE AND 


3106 CD6000 


02320 




CALL 


0060H 


; DELAY CALL TO ROM 


3109 7A 


02330 




LD 


A,D 


; GET STORED VALUE BACK 


310A C5 


02340 




PUSH 


BC 


; SAVE BC REGISTER 


310B F5 


02350 




PUSH 


AF 


; SAVE ACCUM AND FLAGS 


31 OC 0640 


02360 




LD 


B.40H 


; GET NOTE LENGTH VALUE 


31 OE 3A3D40 


02370 




LD 


A.(PORTFF) 


i GET STATUS OF SCREEN 


3111 E6F0 


02380 




AND 


OFDH 


; MASK SCREEN CHANGE OUT 


3113 67 


02390 




LD 


H,A 


; STORE MSB IN H REG. 


3114 F602 


02400 




OH 


2 


; SET BIT 1 TO BE ON 


3116 6F 


02410 




LD 


L,A 


; STORE ALT. MSB IN L REG 


3117 7D 


02420 


BEEPER 


LD 


A,L 


; GET ALT. MSB TO OUTPUT 


3118 03FF 


02430 




OUT 


I0FFH1.A 


; AND OUTPUT RISING WAVE 


31 1A 7C 


02440 




LD 


A,H 


; NOW GET NORMAL MSB 


3118 D3FF 


02450 




OUT 


[OFFH),A 


; AND OUTPUT FALLING WAVE 


311D C5 


024E0 




PUSH 


BC 


; SAVE NOTE LENGTH REG. 


311 E D64CJ 


02470 




LD 


B.40H 


; GET FREQUENCY DELAY 


3120 10FE 


02480 


FREOCY 


DJNZ 


FREOCY 


; AND WAIT A LITTLE WHILE 


3122 CI 


02490 




POP 


BC 


; NOW RESTORE LENGTH VAL. 


3123 10F2 


02500 




DJNZ 


BEEPER 


; AND GO BACK THAT LENGTH 


3125 F1 


02510 




POP 


AF 


; RESTORE ORIGINAL CHAR. 


3126 C1 


02520 




POP 


BC 


; AND RESTORE ORIGINAL BC 


3127 C35204 


02530 




JP 


0452H 


; BACK TO ROM IN PROGRESS 


/ 


02540 


; 










02550 


; fiitiiiittiitiitiitittiiiiitiitntiniittiiitnii,,,,,, 




02560 


; THIS 


IS LOWER CASE DETERMINATION FROM STORED INFO 




02570 


; Hint, mult, ti,,i,i, >,!,,,,, ii,,H,,t,,t, tumult, 




02580 


; 








31 2A F5 


02590 


LOWER 


PUSH 


AF 


; SAVE NEEDED REGISTER 


31 2B 3A1940 


02600 




LD 


A.ISHIFTR) 


; GET STATUS OF SHIFTLOCK 


31 2E FE01 


02610 




CP 


1 


j CHECK IF STATUS ■ 1 


3130 2804 


02620 




JR 


Z.L0WER1 


i IF SO THEN GO TO L.C. 


3132 F1 


02630 




POP 


AF 


T ELSE GET ORIGINAL VALUE 


3133 C35804 


02640 




JP 


045BH 


i LEAVE TO NORMAL DISPLAY 


3136 F1 


02650 


L0WER1 


POP 


AF 


; ELSE GET ORIGINAL VALUE 


3137 D06E03 


02660 




LD 


L.IIX+3] 


; GET CURSOR LSB INTO L 


313A D06604 


02670 




LD 


H.lIX+4) 


; GET CURSOR MSB INTO H 


3130 OASA04 


026 BO 




JP 


C.D49AH 


; BACK TO ROM IF CARRY 


3140 DD7E05 


02690 




LU 


A.UX+5) 


; GET CURSOR CHARACTER 


3143 B7 


02700 




OP 


A 


; TEST IF CURSOR IS ON 


3144 2801 


0271D 




Jfi 


Z, GETCHR 


; IF NOT THEN GO DD IT 


3146 77 


02720 




LD 


[HLJ.A 


; ELSE PUT IT BACK 


3147 79 


02730 


GETCHR 


LD 


A,C 


; GET VALUE TO DISPLAY 


3148 FE20 


02740 




CP 


20H 


; IS IT A SPACE OR CNTRL? 


31 4A 0A0605 


02750 




JP 


C.0506H 


; OUT IF SPACE OR CONTROL 


3140 FEBO 


02760 




CP 


BOH 


; IS IT GRAPHICS OR TAB? 


314F 02A604 


02770 




JP 


NC.D4A6H 


; OUT IF GRAPHICS OR TAB 


3152 C37D04 


027 BO 
02790 




JP 


047DH 


; 00 UNCONVERTED DISPLAY 




02BO0 


; Ittltltt 


06CC 


02810 




END 


06CCH 


; BACK TO BASIC READY 


00000 TOTAL ERRORS 










24295 TEXT AREA BYTES LEFT 








AROUND 3090 


01460 


01370 








BACKUP 30B7 


01350 


01400 








BEEEEP 30E6 


02140 










BEEPER 3117 


02420 


02500 








BLEEEP 3103 


02310 


02160 


02190 






CLRMEM 3052 


00800 


00820 








CNTROL 30AC 


01710 


01600 








DECA 3 07 A 


01130 


01070 








FOUND 307F 


01230 


00990 








FREOCY 3120 


02460 


02480 








GETCHR 3147 


02730 


02710 









Listing Continued . 



crude first pass; enter this line from command 
level (no line number): 

FOR X=17130 TO 32767 : IF PEEK(X1=178 THEN POKE X.175 : NEXT 

This line will search through .all of memory 
(in a 16K machine), looking for the PRINT 
token (via PEEK), and replacing it wherever it 
finds it with the LPRINT token (via POKE). 

There are occasional risks with this kind of 
POKEing. Occasionally, a line number or part 
of the BASIC line organization addresses may 
have the same value as the PRINT token and 
get changed with this process. You might end 
up with a line like 37549 in the middle of a 
nicely ordered sequence of 1000, 1010, 1020, 
etc. Another possible flaw is that the value 
stored as a pointer to the next BASIC line may 
also correspond to the PRINT token, and get 
changed. You may get into a LIST-loop or 
'lose' some lines (at least to the eye - they are 
still in there). 

If a line number is wrong, merely delete the 
incorrect line number and retype a new line 
with the correct number. If some lines seem 
lost or the LIST command keeps looping, then 
temporarily reverse the process . . . 

FOR X=17130 TO 32767 : IF PEEK[X)=175 THEN POKE X.178 : NEXT 

. . . and add a few REM statements in a line 
before the error occurred. Adding statements 
will alter the position of program lines in 
memory, and you will probably be able to 
perform the original conversion again safely. 

As you can see, the tokenizing process has a 
lot of distinct advantages. As a postscript, 
consider the program that opened this section. 
The tokens were displayed as graphics 
characters. Why is this so? 

Since there are only 256 possible 
combinations of bits in a byte, many times they 
have to serve multiple masters. In a machine 
language program, these bytes can be 
instructions. In a BASIC program, they are 
tokenized commands. On screen - which 
means in video memory - they appear as 
graphics. The 26 letters of our alphabet can be 
combined and recombined to form words, 
sentences, paragraphs, etc., and many words 
can sound alike or be spelled alike and still 
have different meanings. Context changes how 
words are understood. 

Douglas Hofstadter played on this most 
dramatically when he wrote, "This sentence no 
verb". 
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Packing BASIC With Machine Code 



Continued Listing 

GOAWAY 3DE5 02130 01630 01700 01730 01810 01830 01930 
01000 
00350 
00730 

00910 01030 01050 01140 
00370 
02620 
02370 

01020 01120 
02200 02220 02600 
005S0 
01880 
01100 
01510 
01780 
01750 
01860 



INKEYS 4099 00250 
KBPFIX 3039 00450 
KEYPRS 3041 00630 
KPLACE 401A 00270 
LOWER 31 2A 02590 
L0WEH1 3136 02650 
PORTFF 403D 00260 
RECHEK 3047 00630 
SHIFTH 4019 00280 
STROKE 305E 00980 
TABLET 3005 02000 
TMWSTE 3075 01100 
Z0429H 30B1 01740 
Z0435H 30BD 01 BOO 
Z043DH 30C5 01840 
Z0443H 30CB 01880 
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00100 ; 


ttttt 


ttlltllt 


tttittnttittttttt 


Ittttttltltlltttllllllll 




00110 ; 


ADDING DEBOONCE/BEEP/AUTOREPEAT 


TO EDITOR/ASSEMBLER 1 .1 




00120 ; 


ttttiirrmifitnitnttifiimitmttmmnHumtu 




00130 ; 


NEW EDTASM SCAN PATCH WILL USE 


ROM ROUTINE IN ITS PLACE 




00140 ; 


ftimiti tint ntt tun tutf tun tut tiimmintunt 




00150 ; 










4016 


00160 




ORG 


4016H i 


KEYBOARD PATCH POINT 


4016 68 


00170 




DEFB 


06BH ; 


LSB OF NEW START 


4017 50 


00180 




DEFB 


050H ; 


MSB OF NEW START 


5D68 


00190 




ORG 


5D68H ; 


NEW PARTIAL KBO DRIVER 


5068 211640 


00200 




LD 


HL.4016H ; 


FORMER KBD PATCH POINT 


5D6B 36E3 


00210 




LD 


(HL) ,0E3H ; 


LSB OF ADDRESS IN ROM 


5D6D 23 


00220 




INC 


HL ; 


GET NEXT POSITION READY 


5D6E 3603 


00230 




LD 


(HL),03H i 


MSB OF ADDRESS IN ROM 


5D70 C38A46 


00240 
00250 




JP 


468AH i 


JUMP TO EDTASM PROGRAM 




00260 


ttttttttttmtt 


ttiittntttttttittttitii 




00270 


NEW KEYBOARD 


SCAN IS PLACED AT 


FORMER SOURCE CODE START 




00280 


ttttttttttittiitittttttttttitti 


ttttttttittitttttttttitt 




00290 










5000 


00300 




ORG 


5000H 


NEW BLOCK OF CODE 


5D00 212140 


00310 




LD 


HL.4021H 


GET REPEAT STORAGE BYTE 


5003 010138 


00320 




LD 


BC.3801H 


GET FIRST ROW OF KEYBRD 


5006 1600 


00330 




LD 


0,0 


ROW COUNTER REGISTER 


5008 OA 


00340 


LOOPX 


LD 


A,[BC) 


FIND KEY PRESSED IN ROW 


5008 5F 


00350 




LD 


E,A 


SAVE VALUE IN E REG. 


5D0A A3 


00360 




AND 


E 


TEST FOR PRESSED KEY 


5D0B 2018 


00370 




JR 


NZ, FOUND 


JUMP OUT IF KEY PRESSED 


5D00 77 


00380 




LD 


[HL),A 


SAVE CURRENT KEY IN HL 


5D0E 14 


00390 


REDOIT 


INC 


D 


INCREMENT ROW COUNTER 


5D0F 2C 


00400 




INC 


L 


INCREMENT KEY STORAGE 


5010 CB01 


00410 




RLC 


C 


GET NEXT ROW INTO BC 


5D12 78 


00420 




LD 


A,C 


GET VALUE OF C FOR TEST 


5013 06BO 


00430 




SUB 


BOH 


BOH IS SHIFT KEY ROW 


5D15 20F1 


00440 




JR 


NZ, LOOPX 


LOOP BACK IF NOT SHIFT 


5D17 0607 


00450 




LD 


8,7 


; NUMBER OF BUMPS TO DO 


5D19 20 


00460 


LOOPY 


DEC 


L 


; DECREMENT BYTE STORAGE 


5D1A 86 


00470 




ADD 


A,(HL) 


i ADD TOTAL VALUE STORED 


5D1B 10FC 


00480 




DJNZ 


LOOPY 


; LOOP BACK FOR 7 TIMES 


501 D FEOO 


00490 




CP 





; WERE NO KEYS PRESSED? 


501 F 3E00 


00500 




LD 


A,0 


; CLEAR ACC, NOT FLAGS 


5D21 CO 


00510 




RET 


NZ 


; BACK TO MAIN ROUTINE 


5022 321A40 


00520 




LD 


[401AH),A 


; SAVE VALUE IF ZERO 


5025 C9 


00530 




BET 




j BACK TO MAIN ROUTINE 


5D26 A6 


00540 


FOUND 


AND 


(HL) 


; TEST IF SAME CHARACTER 


5D27 2810 


00550 




JR 


Z.SAHE 


; IF SAME, JUMP OUT . . . 


5029 3A1A40 


00560 




LD 


A,(401AH) 


; GET COUNTER BYTE INTO A 


5D2C 3C 


00570 




INC 


A 


; INCREMENT IT EACH TIME 


5D2D 321A40 


00580 




LD 


I401AH),A 


; SAVE IT AGAIN FOR NEXT 


5030 FEFF 


00580 




CP 


OFFH 


; IS IT PAST FULL DELAY? 


5032 20DA 


00600 




JR 


NZ, REDOIT 


; IF NOT GO BACK FOR MORE 


5D34 30 


00610 




DEC 


A 


; DEC A TO OFE FOR REPEAT 


5035 321 A40 


00620 




LD 


I401AHJ.A 


; SAVE THAT VALUE IN CNTR 


5038 7B 


00630 




LD 


A,E 


; GET ORIGINAL CHARACTER 


5D39 73 


00640 


SAME 


LO 


(HL).E 


; SAVE THAT VALUE IN HL 


5D3A C5 


00650 




PUSH 


BC 


j SAVE ROW COUNTER 


5D3B 010002 


00660 




LD 


BC,0200H 


; GET DELAY VALUE READY 


5D3E CD6000 


00670 




CALL 


0060H 


; CALL ROM DELAY SUBROUT. 


5D41 C1 


00680 




POP 


BC 


; RESTORE ROW COUNTER 


5042 OA 


00690 




LD 


A,(BC) 


J GET VALUE AT ROW CNTR. 


5D43 A3 


00700 




AND 


E 


; TEST IF STILL PRESSED 


5044 CB 


00710 




RET 


Z 


; IF NOT THEN IT'S BOUNCE 


5D45 C5 


00720 




PUSH 


BC 


; SAVE ROW COUNTER AGAIN 


5046 E5 


00730 




PUSH 


HL 


i SAVE STORAGE AREA 


5D47 F5 


00740 




PUSH 


AF 


; SAVE CURRENT KEYSTROKE 


5D48 0640 


00750 




LO 


B.40H 


; GET DURATION VALUE 


5D4A 3A3D40 


00760 




LD 


A, (403 OH) 


; GET STATUS OF SCREEN 


5D40 E6F0 


00770 




AND 


OFDH 


; CLEAR THE DATA OUTPUT 


5D4F 67 


00780 




LD 


H,A 


; H BECOMES OUTPUT MASK 


5050 F602 


007 98 




OR 


02 


i READY ACC. FOR BIT-SET 

Listing Continued . . 


Chapter 3 











Packing BASIC With Machine Code 

One of the most attractive aspects of 
interpreted code like Level II BASIC is the 
hide-n-seek game you can play with it. One of the 
most fruitful games is called 'string packing', a 
technique that allows machine language 
programs to be hidden inside ordinary program 
lines. 

It is convenient and efficient, but once it's part 
of a program, it looks very obscure. There are 
three ways of creating machine-coded programs 
through BASIC strings, but all depend on the 
code being relocatable (see Supplement to 
Chapter 4 regarding relocatable code). The three 
ways are: 

1. Packing the machine code into a string 
on a program line, one character at a time. 
This is done when the program is created. 

2. Packing the machine code into a string 
on a program line, one character at a time, 
reading data on other program lines. This is 
done each time the program is run. The 
read/data lines containing the packing 
information are then automatically deleted. 

3. Building a string in the string variable 
area from in-line CHR$() commands. The 
strings are built each time the program is 
run. 

First, some background on strings and how to 
find them. In the TRS-80, all variables can be 
located with a Level II command known as 
VARPTR (VARiable PoinTeR). The variable 
pointer can find out a lot about variables - their 
type, location, and length. In the case of string 
variables, VARPTR returns a memory location 
in which the length of the string is stored. 

Assume A$ is a string variable in a program 
line. The statement X=VARPTR(A$) assigns 
the address of the first part of the A$ story to X. 
Here's what X can reveal: 

PEEK (X) ...ths length of At 

PEEK (X+1) ...ths least significant byta of ahara Al Is found 

PEEK (X+2) ...ths aost slgnlf leant byta of chars A* 1s found 

These values are returned in decimal form, 
because Level II doesn't provide a hexadecimal 
numbering option. To find where A$ is actually 
located, then, use this formula: 

AD = PEEK (X+1 ) + 266 • PEEK (X+2) 

Do you see what is happening here? And what 
can be done with it? If you know, for example, 
that A$="XXXXXXXXXX", then you can 
actually change A$ by POKEing values into the 



Continued Listing 



5052 6F 


00800 




LD 


L,A 


; L BECOMES OUTPUT MASK 


5053 7D 


00810 


SOUND 


LD 


A,L 


; GET BIT-SET MASK 


5054 D3FF 


00820 




OUT 


(OFFHl.A 


; OUTPUT IT [WAVEFORM HI) 


5056 7C 


D0830 




LD 


A,H 


i GET BIT-RESET MASK 


5D57 D3FF 


00840 




OUT 


(OFFHJ.A 


; OUTPUT IT (WAVEFORM LO) 


5059 CS 


00850 




PUSH 


BC 


; SAVE DURATION VALUE 


S05A 0640 


00860 




LD 


B,40H 


; GET PITCH VALUE 


5D5C 10FE 


00870 




DJNZ 


t 


; DELAY FOR AUOIBLE TONE 


505E CI 


00680 




POP 


BC 


; RESTORE BEEP DURATION 


5D5F 10F2 


00890 




DJNZ 


SOUND 


; LOOP FOR FULL DURATION 


5D61 F1 


00900 




POP 


AF 


, RESTORE KEYSTROKE VALUE 


5D62 E1 


00910 




POP 


HL 


RESTORE STORAGE VALUE 


5D63 C1 


00920 




POP 


BC 


RESTORE ROW COUNTER 


5064 C30744 


00930 
00940 




JP 


4407H 


JUMP INTO EDTASM. . . I 




00950 


; tHun,f,ll,,t,,,,,,,,,t,,,t,,lli,,,l,t,tHIHH,ttllt 




00960 


i FOLLOWING PATCH NEW SOURCE CODE START & KEYBOARD SCAN 




00970 
00980 


; tti>iniitttnm,ti)>nminii,,,i,,uitttitiiiiimt 


46 BA 


00990 




OHG 


46 BAH 


PLACE TO PATCH END 


468A 21005E 


01000 




LD 


HL.5E00H 


NEW END OF EDTASM 


4710 


01010 




ORG 


471 OH 


PLACE TO PATCH END 


4710 11005E 


01020 




LD 


DE.5E00H 


NEW END OF EDTASM 


4A07 


01030 




ORG 


4A07H 


PLACE TO PATCH END 


4A07 11005E 


01040 




LD 


DE.5E00H 


NEW END OF EDTASM 


4A0B 


01050 




ORG 


4A0BH 


PLACE TO PATCH END 


4AD8 21005E 


01060 




LD 


HL.5E00H 


NEW ENO OF EDTASM 


4650 


0107D 




ORG 


4B50H 


PLACE TO PATCH END 


4B50 21005E 


01080 




LD 


HL.5E00H 


NEW END OF EDTASM 


4039 


01090 




ORG 


4D39H 


PLACE TO PLACE END 


4039 21005E 


01100 




LD 


HL.5E00H 


NEW ENO OF EDTASM 


4080 


01110 




ORG 


4080H 


PLACE TO PATCH END 


40B0 21005E 


01120 




LD 


HL.5E00H 


NEW END OF EDTASM 


5227 


01130 




ORG 


5227 H 


PLACE TO PATCH END 


5227 21005E 


01140 




LD 


HL.5EO0H 


NEW END OF EDTASM 


43 EF 


01150 




URG 


43EFH J 


PLACE TO PATCH KBD SCAN 


43EF C30050 


01160 
01170 




JP 


5D00H 


NEW KEYBOARD SCAN 




01180 


; Httttn 


fff#*»#f#w##«#N#m#f 


5000 


01190 




END 


5D00H 




00000 TOTAL 


ERRORS 










30935 TEXT 


AREA BYTES LEFT 








FOUND 5026 


00540 


00370 








LOOPX 5008 


00340 


00440 








LOOPY 5019 


00460 


00480 








REDOIT 500E 


00390 


0D60O 








SAME 5D39 


00640 


00550 








SOUND 5053 


00810 


00890 









Packing BASIC With Machine Code 

address you have calculated. 

Run the following demonstration program: 

10 CLE 

20 Al « "XXXXXXXXXX" 

30 X = VARPTMAI) 

40 0= PEEK (X) 

SO AD « PEEK (X-H) + 256 • PEEK CX+8) 

60 PRINTA$ 

70 L = 65 

80 FOR N = 1 TO Q 

90 POKE AD,L 

100 L = L + 1 

110 AD = AD + 1 

120 PRINT A* 

130 NEXT N 

140 LIST 20 

A$ is created in line 20, and its information 
storage area is found by X in line 30. Its length is 
discovered in line 30 and assigned to variable Q; 
its location is determined in line 50 (assigned to 
variable AD), and it is printed in its original form 
in line 60. Line 70 assigns the value 65 (an ASCII 
'A') to variable L, and a Q-character loop is 
created in line 80. The first character in A$ is 
POKEd with L, i.e., changed to letter 'A'. L is 
incremented (to letter 'B'), AD is incremented 
(to the next character in A$), and the new A$ is 
printed. When all characters in A$ have been 
changed, it is listed. You can see that the list 
itself is changed because A$ is defined and stored 
right there in line 20! 

As a further experiment, change the value of L 
in line 70 to 129 and watch what happens (see 
Box on Tokenizing for details). 

Here is the point: you can create a dummy 
string like A$ which will become the residence of 
a machine language program. By finding A$ and 
POKEing your program into it, it can be 
CLOADed and CSAVEd at will. 

Now we turn to the three string-packing 
methods themselves. For the sample program, 
the following 20-byte routine will be used: 



21 01 


3C 


LD 


HL.3C01H 


E5 




PUSH 


HL 


D1 




POP 


DE 


2B 




DEC 


HL 


01 FF 


03 


LD 


BC.03FFH 


36 20 




LD 


(HL) ,20H 


ED BO 




LOIR 




21 11 


01 


LD 


HL.0111H 


CD A7 


28 


CALL 


2BA7H 


09 




RET 





This routine clears the screen, prepares the 
message 'RADIO SHACK LEVEL II BASIC, 
and displays it. 

The first and second string-packing methods 
are essentially identical, except that in the first 
method, A$ is created and the program saved for 
later use. The second method creates A$ at every 
program run. Here is a simple BASIC program 
using the routine above packed into A$: 
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4F60 
4F60 
4F64 



4F67 
4F68 
4F6B 
4F6E 
4F6F 
4F72 
4F75 
4F7 8 



4F7B 
4F7C 
4F7E 
4F7F 
4F80 
4F83 
4F85 
4F8E 
4F87 
4F8A 
4FBC 
4F8D 
4F8E 
4F91 
4F93 
4F94 
4F95 
4F9B 
4F9A 



00210050 
01FF4F 



09 

D04600 

004E01 

DS 

DD6602 

DD6E03 

DD5604 

DD5E05 



OA 

E60F 

24 

25 

C2854F 

CBE7 

2C 

20 

C28C4F 

CBEF 

14 

15 

C2934F 

CBF7 

1C 

10 

C29A4F 

CBFF 

02 



4F9B 
4F9C 
4F9D 
4FA0 
4FA2 
4FA5 
4FAB 
4FAA 
4FAC 



4FAE 
4FAF 
4FB2 
4FB4 
4FB7 
4FBA 
4FBC 
4FBE 



4FC0 
4FC1 
4FC4 
4FC6 
4FC9 
4FCC 
4FCE 



CA 

25 

C2AB4F 

EE01 

DDBB02 

C3AE4F 

FDE5 

F0E1 

E6FF 



20 

C2BA4F 

EE02 

00BE03 

C3C04F 

F0E5 

F0E1 

E6FF 



15 

C2CC4F 

EE04 

D05B04 

C3D24F 

F0E5 

FDE1 



00100 

00110 

00120 

00130 

00140 

00150 

001S0 

00170 

0018Q 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

002B0 

00270 

002BO 

00290 

00300 

0310 

00320 

00330 

00340 

00350 

OO360 

00370 

00380 

00390 

00400 

0041 

00420 

00 43 

00440 

00450 

00460 

00470 

00480 

00490 

00500 

00510 

00520 

00530 

00540 

00550 

00560 

570 

00580 

00590 

00600 

00610 

00620 

00630 

00640 

00650 

00660 

00670 

00680 

00690 

00700 

00710 

00720 

00730 

00740 

00750 

00760 

00770 

007B0 

007 90 

OOBOO 

00810 

00820 

00830 

0DB40 

00850 

00860 

00870 

08 SO 

00890 

00900 

00910 

00920 

00930 

00940 

00950 

00960 

00970 

00960 

00990 

01000 

01010 

01020 

01030 

01040 

01050 

01060 

01070 

01080 

01090 

01100 

01110 

01120 

01130 



if tit it tttt it tit iff tint ftittititt it ftiiiift tut Hit ft 

ELEMENTARY [AND SLOW! FOUR-VOICE MUSIC SUBROUTINE. 
THIS ROUTINE IS CURRENTLY SET UP FOR FOUR INDEPENDENT 
VOICES. BECAUSE OF TIMING CONSTRAINTS, VOICES ARE VERY 
LOW IN PITCH. BY USING THE FOUR SUBROUTINES ALTERNATE- 
LY FOR SOUND EFFECTS, A HI6HER SPEED CAN BE OBTAINED. 
A TEST-AND-JUMP LOOP CAN BE INSERTED FOR THIS PURPOSE. 
ALSO, AS LONG AS LABELS ARE CHANGED, VOICES CAN BE 
DROPPED FROM THE SEQUENCE, RESULTING A 50%, 100% AND 
150% SPEED INCREASE, RESPECTIVELY. SQUARE WAVE OUTPUT. 
NOTICE ALSO THAT, WHEN VOICES ARE DROPPED, OTHER REG- 
ISTERS MAY BE SUBSTITUTED FOR IX, FOR A SPEED INCREASE. 
FURTHERMORE, CHANGING THE SPEED OF THE PROCESSOR WILL 
PROVIDE AN IDENTICAL INCREASE IN THE OUTPUT PITCH. 
iniiiliintilimliiiinlillllriuiiluilitMlllM.nl 



:NEAR TOP OF MEMORY 
:START PITCH & RHYTHM 
:MEMORY-MAPPED SOUND 



iitiiitiiiiiiitiiiiitiiitiiiiiiiituuiuuitttnmiti 

OUTER (INTER-NOTE) LOOP BEGINS HERE; T-STATES 212 - 244 

iitttttttit i tt ill tint ttiiititiiiiittt if intuitu it hi 



ORG 


4F60H 


LO 


IX.5000H 


LD 


BC.4FFFH 



; 04 .-READY DURATION REGS. 
; 1 a : MSB OF NOTE DURATION 
;19:LSB OF NOTE DURATION 
;04:STASH REGISTER AWAY 
;19:FIRST PITCH INTO H 
;19:SEC0ND PITCH INTO L 
;19:THIRD PITCH INTO D 
;19:F0URTH PITCH INTO E 



; itif.ittlllit till tltillliitltt.lllltltltttlllllltllt til 

; EACH VALUE ACQUIRED FROM IX IS TESTED TO SEE IF IT IS 

j AND THE VOICE IS TURNED OFF IF IT IS (DEFINING A REST). 

; tmiiiiitttf tit if tiititiill II ttltii tin till titttltti tl 



LD 


B 


UX+O) 


LD 


C 


[IX+11 


EXX 






LD 


H 


(IX+2) 


LD 


L 


(IX+3] 


LD 





(IX+4) 


LD 


E 


(IX*5) 



LD 

AND 

INC 

DEC 

JP 

SET 

INC 

DEC 

JP 

SET 

INC 

DEC 

JP 

SET 

INC 

DEC 

JP 

SET 

LD 



A,(BC) 

OFH 

H 

H 

NZ ,REST1 

4, A 

L 

L 

NZ.REST2 

5, A 

D 

D 

NZ.REST3 

6 ,A 

E 

E 

NZ ,REST4 
7, A 
[BO ,A 



;07:READY TO TWEAK MEM 
;D4:TURN ALL VOICES ON 
;04:BUMP VALUE; REST TEST 
;04:BUMP VALUE; REST TEST 
;10:0NLY 00 DEFINES REST 
;OB:SILENCE VOICE IF REST 
;04:BUMP VALUE; REST TEST 
;04:BUMP VALUE; REST TEST 
;10:ONLY 00 DEFINES REST 
;08:SILENCE VOICE IF REST 
;04:BUMP VALUE; REST TEST 
; 04: BUMP VALUE; REST TEST 
;10:ONLY 00 DEFINES REST 
;OB:SILENCE VOICE IF REST 
:04:BUMP VALUE; REST TEST 
;04:BUMP VALUE; REST TEST 
;10:ONLY DO DEFINES REST 
;08:SILENCE VOICE IF REST 
;07:SET VOICES ON OR OFF 



f I If fit! fftf tilt I llltlllfttllllltf Iff fttllltltf lit It lit 

DECREMENT H,L,D,E IWAVEFORM DURATION FOR EACH VOICE)... 
NEEDED EACH TIME THE WAVEFORM IS TOGGLED DURING LOOPS.. 
...INNER LOOP BEGINS HERE. T-STATES STRICTLY EDUAL 246 
MEANING MAXIMUM FREQUENCY IS APPROXIMATELY 1770000/246 
OR 7195.1 HZ. USEFUL FREQUENCIES ARE CONSIDERABLY LESS. 
fftlttltitlittif III tfllfrftf Iff liltllllllf lit If lift tilt 

BEGIN PITCH AND RHYTHM COUNTDOWN LOOPS 
flfflffffttflffflltlflllfltl lift It fill ttltfllltlllllltt 

COUNT DOWN THE PITCH LOOP FOR VOICE NUMBER ONE 
ff tiff f fflf If ft f If f ft fffff till! I till Iff ft f Iff llltltill! 



LD 

DEC 

JP 

xon 

LD 

JP 

PUSH 

POP 

AND 



A, [BO 

H 

NZ.EXIT1 

1 

H.1IX+2) 

EXIT1A 

IY 

IY 

OFFH 



;07:WHAT WAVE IS LURKING 
;04:C0UNTD0WN FREQUENCY 1 
;10:SAME WAVE IF NOT 
;07:T0GGLE WAVEFORM BIT 1 
;19:REST0RE PITCH VALUE 
;10:JUMP PAST TIMEWASTERS 
;15:WASTE 15 T-STATES 
;14:WASTE 14 T-STATES 
; 07: WASTE 7 MORE T-STATES 



If if ff ft tf f f f t tt t f tr 1 1 1 1 1 f ttt t tit f 1 1 rtitt ttt f rt ttt ttttt 

COUNT DOWN THE PITCH LOOP FOR VOICE NUM8ER TWO 
flirt fl't'ltftflflHt fit tfltlfttttlf If III ttt Iff lllllllt 



DEC 

JP 

XOR 

LD 

JP 

PUSH 

POP 

AND 



NZ.EXIT2 

L,(IX+3) 

EXIT2A 

IY 

IY 

OFFH 



;04:C0UNTD0WN FREQUENCY 2 
; 10. -SAME WAVE IF NOT 
;07:T0GGLE WAVEFORM BIT 2 
;18:REST0RE PITCH VALUE 
;10:JUMP PAST TIMEWASTERS 
;15:WASTE 15 BANANAS 
;14:DRUM FINGERS ON 14 
;07:USELESS ARITHMETIC 



if f rf iff tliff f itirittrf rtiiiiitiit tf tif.tttf tt,f tttt,,i 

COUNT DOWN THE PITCH LOOP FOR VOICE NUMBER THREE 
ft Iff f Iff f lilt f till ttlfff tlltltllltllf Iff I Iff If Iff ttlf I 



DEC 

JP 

XOR 

LD 

JP 

PUSH 

POP 



NZ.EXIT3 

4 

0,(IX+4) 

EXIT3A 

IY 

IY 
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;04:C0UNTD0WN FREQUENCY 3 
;10:SAHE WAVE IF NOT 
;07:T0GGLE WAVEFORM BIT 3 
;19:REST0RE PITCH VALUE 
;10;JUHP PAST TIMEWASTERS 
;15:SCRATCH LEFT HAND 
;14:SCRATCH RIGHT HAND 

Listing Continued . . . 



5 POKE 16553,255 : REM OPTIONAL LINE 

10 PRINT"THE PROGRAM IS RUNNING" 

80 A$ = "1 2345678901 234567890" 

30 X = VARPTR IA») : Q " PEEK (X) 

40 AD = PEEK (X+1) + 256 * PEEK IX+2) 

50 FOR N ■ 1 TO Q : READ A 

60 POKE AD, A : AO = AO + 1 : NEXT 

70 HB = PEEK (X+1) : POKE 16526, HB 

80 LB = PEEK (X+2) : POKE 16527, LB 

SO INPUT"ENTEfi TO RUN M/L";Z 

100 Mt ■ USR (0) 

110 DATA 33,1,60,229,209,43,1,255,3,54 

120 DATA 32,237,176,33,17,1,205,167,40,201 



Line 5 is optional if you have an early ROM set, 
where data reads could RESTORE after every 
READ. Line 20 contains the string to be packed, 
and, as before, lines 30 and 40 identify the 
string's length and location. The data is read and 
POKEd into place sequentially by lines 50 and 
60. 

Finally, lines 70 and 80 identify the beginning 
of the string and place it in the USR(X) entry 
points at 16526 and 16527. The program pauses 
for user input in line 90, and then jumps to the 
packed routine. 

After the program has been run, list it. Note 
that A$ is now packed with new information 
replacing the string '12345678901234567890'. 
The first string-packing method saves space by 
deleting lines 40 through 60, 110 and 120, which 
have done their work. The program is then 

CSAVEd, and can be loaded and run at any time. 
The second string-packing method leaves all 
lines intact so that any future users may modify 
them as necessary. 

There are a few disadvantages to this method 
of string packing. First of all, two machine 
language instructions or pieces of data may not 
be used directly: 00 and 22. 00 tells a BASIC 
program it has found the end of a program line; 
two 00's in a row indicate the end of the program. 
22 is the quotation mark symbol, and will inform 
the program that the string has ended; a ?SN 
ERROR will then be produced in the rest of the 
line. 

A second difficulty is that the line containing 
A$ may not be edited. This is because when a line 
is edited, it is placed from the LIST into a buffer 
that acts exactly like the keyboard buffer; the 
bytes within the quotes are then converted into 
the individual letters. For example, code (178) is 
a machine command which also is the BASIC 
token for PRINT; when listed, it comes up on the 
screen as PRINT. Editing the line puts 
P-R-I-N-T in the edit buffer; but since it is 
within the quotation marks, it is not tokenized. 
The result? The string now contains five ASCII 
characters where it once contained a machine 
language instruction! 



Packing BASIC With Machine Code 



Continued Listing 




4FD0 


E6FF 


01140 
01150 


AND OFFH ;07:CHECK KITCHEN CLOCK 






01160 


11111111111111111111111111111,1111111111111111111111111 






01170 


COUNT DOWN THE PITCH LOOP FOR VOICE NUMBER FOUR 






01180 


mmiimmmmmmmmmimmmmmmi 






01190 




4FD2 


1D 


01 200 


:XIT3A DEC E ; 04 : COU NTDOWN FREQUENCY 4 


4FD3 


C2DE4F 


01210 


JP NZ.EXIT4 ;10:SAME WAVE IF NOT 


4FD6 


EEOB 


01 220 


XOR 8 ;07:T0GGLE WAVEFORM BIT 4 


4FDB 


DD5E05 


01230 


LD E,(IX+5] ;18:REST0RE puCH VALUE 


4FDB 


C3E44F 


01 240 


JP EXIT4A ;10:JUMP PAST TIHEWASTERS 


4FDE 


FDE5 


01250 


LXIT4 PUSH IY J15:WATER NASTURTIUMS 


4FED 


FDE1 


01260 


POP IY . ;14:PICK 14 ZUCCHINI 


4FE2 


E6FF 


01270 
01 280 


AND OFFH ;D7:HIX APPLES AND ORANGE 






01 290 


it mmmtimmmtttmmtmmmmmmmti 






01300 


CHECK FOR END OF NOTE DURATION; GET MORE NOTES IF DONE 






01310 


mmmmmmmummmmmmtmmtmm 






01320 




4FE4 


02 


01330 


EXIT4A LO [BO, A ;07:0UTPUT NEW WAVEFORMS 


4FE5 


Dfl 


01340 


EXX ;04:GET STASHED DURATION 


4FE6 


OB 


01350 


DEC BC ;06:C0UNT DOWN DURATION 


4FE7 


76 


01360 


LD A, 8 ;04:SET UP B FOR TEST 


4FE8 


B1 


01370 


OR C ;04:CHECK AGAINST C 


4FE9 


D9 


013B0 


EXX ;04:STASH DURATION AGAIN 


4FEA 


C29B4F 


01390 
01400 


JP NZ.L00P2 ;10:G0 BACK TIL NOTE END 






01410 


n mmmmmmmtmmmmmimmmmm 






01420 


MOVE ALL POINTERS PAST CURRENT BATCH OF NOTES/DURATIONS 






01430 


...THIS IS THE REMAINDER OF OUTER LOOP, T-STATES = 80, 






01440 


TOTAL T-STATES OF OUTER LOOP = BO + 244 = 324, WHICH IS 






01450 


ABOUT 2 OF THE HAXIMUM CYCLE FREQUENCIES 1.0002 USEC). 






01460 


ttttuntintmttmitittttntntttntnttmitnmtnt 






01470 




4FED 


110600 


01480 


LD DE,6 ;10:MEMORY POS'NS TO MOVE 


4FFD 


D019 


01490 
01500 


ADD IX, DE ;15:M0VE 6 PLACES FORWARD 






01510 


ii mmmiimimmimiiimmmmmmiimii 






01520 


CHECK FOR END OF PROGRAM CODE [00) OR DEPRESSED BREAK 






01530 


ii 1 1 1 1 mi mm ill mm mmm m m mtmimm i 






01540 




4FF2 


D07E00 


01550 


LD A,[IX+0) ;19:NEXT NOTE DURATION 


4FFS 


B7 


01560 


OR A ;04:SET END-OF-MUSIC FLAG 


4FFB 


CS 


01570 


RET Z i05:BACK TO BASIC IF DONE 


4FF7 


3A403B 


015B0 


LD A.I3B40H) 1 13 I TEST BREAK KYBD ROW 


4FFA 


B7 


01590 


OR A ;04:SET FLAG FOR KEY TEST 


4FFB 


CA674F 


01600 


JP Z.L00P1 ;10:CONTINUE PIECE IF OK 


4FFE 


C9 


01610 
01620 


RET ; :T0 BASIC IF BREAK 






01630 


ntttitminiittmiiiiniimmiintnitimiumii 






01640 




06CC 




01650 


END D6CCH ; :READY AFTER SLASH 


00000 TOTAL 


ERRORS 





The last method of string packing is capable of 
overcoming both these flaws. Examine the 
listing below: 

10 PRINT"THE PROGRAM IS RUNNING" 

20 AS = CHHSI33! + CHRSm + CHRtlBO) + 

CHR$(229) + CHRJ1209) + CHR$(43) + 
CHRtiU + CHRH255) + CHR$[3J + 
CHRK54) + CHR$(32l + CHR$[237) + 
CHH»(176] + CHR$(33) + CHR$(17] + 
CHRtM] + CHRt(2D5) + CHR$[167) + 
CHR$[40] + CHRJI201) 



30 X = VARPTR IA»] 

40 POKE 16526, PEEK (X+1) 

50 POKE 16527, PEEK (X+2) 

60 INPUT "ENTER TO RUN M/L";Z 

70 M$ = USR[0) 



This time, A$ has been defined in the BASIC 
variable area using CHR$(). In other words, 
because A$ is no longer defined within the 
program line, any value may be used in the 
machine language program. Hybrid strings can 
also be used, as: 

At = "1234567890" + CHRKO) + "12345" + CHR*(34) 

This method uses both the POKEing via 
READ-DATA statments, plus concatenation 
with 00 and 22 where necessary. Once again, A$ 
is stored in the variable area, and none of the 00's 
or 22's affect the BASIC program. As a final 
amusement, RUN listing 3-(?) above, then 
PRINT A$. The A$ in listing 3-(?) and the A$ in 
this listing both contain identical machine code. 
RUN listing 3-(?) again. LIST line 20. Now 
PRINT A$. The answer is up to you. 

String-packing will likely become a very 

important addition to your library of BASIC 

tools. Here, then, is a summary of the 
string-packing technique: 

1. Write the BASIC program. 

2. Create a dummy string of any unused 
variable name (for example, 
A$="LOONIETUNES" 

3. Make the string the exact length of your 
machine language program. 

4. Write a program line that sets another 
variable to point to the string's variable 
information. 

For example, X = VARPTR(A$). 

5. Find the starting address of the string by 
converting the decimal bytes into a single 
decimal value. 

AD = PEEK(X+1) + 256 * PEEK (X+2). 
6. Create a set of READ and DATA lines in 
your BASIC program which will POKE the 
machine language program into place in the 
dummy string. (For example: 



Line # FOR N = AD TO AD+3 : READ L 
Linn # DATA 33, 16, 16, 204 



POKE N.L : NEXT 



7. Set the USR(0) entry point at 16526 and 
16527 to the beginning of the string variable 
storage address (for example, PEEK (X+1) 
and PEEK (X+2), respectively. 

8. If you wish, delete the READ, DATA and 
POKE loop lines used for that routine. 
CSAVE the program. 
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Sound-Effects Generation 



CDOO 
0003 
0004 
0005 
0006 
0007 
0009 
000C 
000E 
0010 
0011 
0013 
0015 
0017 
0018 
001A 



CD7F0A 
ES 

C1 

C5 

41 

10FE 

3A3040 

F602 

D3FF 

41 

10FE 

E6FD 

D3FF 

C1 

10E8 

CI 



0000 

00000 TOTAL ER 

LOOP 0005 



00100 
00110 
001 SO 
00130 
00140 
00150 
00160 
00170 
00100 
00190 
00800 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 

280 
00300 
00310 
00320 
00330 
RORS 

001 BO 



Sound-Effects Generation 

The essence of sound generation has already 
been sneaked in: the audible beep in the 
keyboard routine at the beginning of this 
Chapter. Sound has been something of a 
mystery, but there could hardly been a simpler 
machine language program. Try this 
experimental program with the tape recorder 
running in record mode (the motor plug 
removed), and a cassette in place: 

10 FORX=1T02O00:0UT255,0:0UT25S,256:NEXT 

In order that this program can operate at top 
speed, make sure you do not use spaces, and keep 
the program on one line. You'll hear the tape 
relay clatter and see the screen jitter. Now play 
back the short segment of tape you recorded. 
There is a buzzing on that tape, similar in pitch to 
the buzzing of the cassette relay. What does all 
this mean? 

It is quite simple. There is an electronic switch 
inside the TRS-80 which controls several 
activities: whether the screen is in 64 or 32 
character mode, whether the cassette relay is on 
or off, and whether the cassette data output is 
'on* or 'off. 

I've put on and off in quotation marks for a 
reason: which video mode is used and whether 
the cassette motor is on or off are examples of 
states or conditions. But in audio terms, the 
latter output represents very swift sound wave 
transitions, not on or off conditions. In other 
words, the transition from on to off or from off to 
on can be heard as only a slight click; but many of 
them in quick succession sound like a buzz; in 
even faster succession, they become actual 
pitches. 



tt tut tut tit tt tutu tit ititt tut it tint it tt it tut tint 

SINGLE-VOICE MUSIC SUBROUTINE FOR USE WITH CASSETTE 
OUTPUT PORT CAN BE EMBEDDED DIRECTLY IN A BASIC STRING 

iiiuiuituuumuuuiuiuuHUUiuuiintmtn 

ACCEPT BASIC VARIABLE 
STASH BASIC VARIABLE 
TRANSFER VAR . TO BC 
SAVE OUTER LOOP VAR. 
GET MSB FOR TONE 
AND DELAY THAT TIME 
GET SCREEN STATUS 
AND SET BIT ONE 
OUTPUT PART OF WAVE 
GET VARIABLE AGAIN 
DELAY WHILE WAVE HIGH 
AND SET OTHER BIT HIGH 
TO 00 OTHER WAVE HALF 
RESTORE OUTSIDE VALUE 
AN0 LOOP BACK FOR FREQ. 
GO BACK TO BASIC 

UlUlnUUUU III till UttUUIUUiutUIUtUI till It 

END 



CALL 


0A7FH 


PUSH 


HL 


POP 


BC 


PUSH 


BC 


L0 


B,C 


DJNZ 


«-0 


LD 


A, (403DH) 


OR 


2 


OUT 


10FFHJ ,A 


LD 


B,C 


0JNZ 


t-0 


AND 


0F0H 


OUT 


10FFH] ,A 


POP 


BC 


0JN2 


LOOP 


RET 





The single-line BASIC program, short though 
it may be, cannot move fast enough to produce 
pleasant tones or dramatic sound effects. For 
that you must turn to machine language for its 
speed. Listing 3-(?) presents a complete sound 
subroutine with ten sample sounds built in. 

Listing 3-(?) presents a different sound 
subroutine which accepts values passed from 
BASIC. 

Again, each program has an advantage. The 
first allows you to tailor specific sounds and their 

durations and repetitions with care; the second 
lets you develop many different sounds easily, 
directly from BASIC, without altering the 
machine subroutine already in place. 



What's in a List? 

Often it's reassuring to be able to give your 
program to others without having to worry about 
gratuitous examination of your code, and finding 
your own, carefully developed techniques in 
someone else's product. The easiest thing to do, 
then, is UN-LIST the program. 

Actually, the program still LISTS, but can't be 

seen; and the program still LLISTs, but uses a 
whole sheet of paper for each line. In either case, 
it's a discouragement if you've got some code you 
like. And protecting just a few lines might give 
the impression that's all there is to your program 
- a psychological ploy. 

The trick is to add two bytes to the end of the 
program: the command to 'Home Cursor', and 
the command to 'Form-Feed'. Here are a few 
normal program lines: 



REMlki 

1 CLS:PRINT:PRINT:PRINT"CHANGING...":X=17128:HEM&& 

2 X=PEEK(X)+256»PEEKO<+1]:PRINTX"... ";:REM&& 

3 IFX=0THEM0ELSEP0KEX-2,28:P0KEX-3,12:G0T02:REM&& 
10 PRINT :PRINT"THIS IS A TEST ";:REM&& 

20 PRINT"0F A TECHNIQUE TO KILL"; :REMSfi 
30 PRINT"THE FEATURE THAT LISTS" j :REH&& 

40 PRINT"OR LLISTS THE PROGRAM ."i REM&& 

SO PRINT"THE PROGRAM HAS NOW BEEN CHANGED" :REM&& 

60 PRINT"A COMPLETE LIST FOLLOWS. .. .":REM&£ 

70 LIST:REH&& 

B0 REM&& 



This process uses four bytes per line (colon, 
REM, two ampersands), and diminishes the 
usable characters per line by six, but if you have 
the memory and think you need a little 
protection, this is a way to go. Delete lines 1, 2 
and 3, and save the program. When LIST is 
commanded, nothing will list on the screen but 
two REM lines (0 and 80). The program will 
require nine sheets of paper to LLIST. 
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Chapter 3 



Autoexecute BASIC Programs 



00100 ; ii,t,,,i,,,i,liii;in,,, ,,,,,,, ,,,,,,,,ltt, ,,,,,,,,,,,, 

00110 ; BASIC AUT0EXECUTION ROUTINE PATCH FOR LEVEL II BASIC 

00120 | ,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,, 

00140 BYTE EOU 1D78H ; INTERPRETER CALL ADDR. 

001 SO ; 

00160 ; mi, ,,r,,,,,i,i,,, ,,,,,,,,,,,,,,,,,,,,,, ,,,,,,!, milt 

00170 ; 



7F00 


00180 




ORG 


7F00H j 


RELOCATE IF DESIRED 


7F00 2A0440 


00190 


START 


LD 


HL,14004H) ; 


GET INTERPRETER PATCH 


7F03 22587F 


00200 




LO 


(RETURN), HL ; 


CHAINING PROCESS HERE 


7F06 210F7F 


00210 




LD 


HL, ENTRY J 


ENTRY OF AUTOEXECUTOR 


7F09 220440 


00220 




LD 


(4004H),HL ; 


PATCH INTO INTERPRETER 


7F0C C3CC06 


00230 
00240 




JP 


06CCH ; 


RETURN TO BASIC READY 




00250 


; mm,, ,,,,,,,,,,,,, m mm,,,,, ,,,,,,,,,,,,,, ##♦### 




00260 


; CHECK 


FOR STATUS OF INTERPRETER 


(MUST BE AT 1D5BH) 




00270 


; miimmmmmmmmmimmmmmitim, 




00280 


i 








7F0F E3 


00290 


ENTRY 


EX 


[SP),HL i 


GET RETURN ADDRESS 


7F10 70 


00300 




LD 


A,L J 


GET LSB INTO A REG. 


7F11 FE5B 


00310 




CP 


5BH ; 


CHECK LSB OF 1D5BH 


7F13 2003 


00320 




JR 


NZ, NOTRDY ; 


GO OUT IF NOT AT 1D5B 


7F15 7C 


00330 




LD 


A,H ; 


GET MSB INTO A REG. 


7F16 FE1D 


00340 




CP 


1DH ; 


CHECK MSB OF 1D5BH 


7F1B E3 


00350 


NOTRDY 


EX 


[SP1.HL ; 


RETURN STACK POSITION 


7F19 C2577F 


00360 
00370 




JP 


NZ.AWAY ; 


BEGONE IF NOT ID5BH 




00380 


; ,,mmmm,,mmtmmtmmm,,m,i,ml,m 




00390 


; COMPARE PRESENT LINE POSITION WITH CLOAD (TOKEN B91 




00400 


; n mum mm mmllmmmmummnimtmt 




00410 


; 








7F1C CD7B1D 


00420 




CALL 


BYTE i 


GET NEXT BUFFER CHAR. 


7F1F F5 


00430 




PUSH 


AF ; 


SAVE PRESENT ACCUM. 


7F20 FEB9 


00440 




CP 


0B9H ; 


SEE IF CLOAD TOKEN 


7F22 2804 


00450 




JR 


Z, CLOAD ; 


SPECIAL ROUTINE IF B9 


7F24 F1 


00460 




POP 


AF ; 


RESTORE PRESENT ACCUM. 


7F25 2B 


00470 




DEC 


HL ; 


RESTORE HL POINTER 


7F26 182F 


00480 
00490 




JR 


AWAY J 


OUT TO NORMAL MODE 




00500 


; uummmmumimimmmmmimmmmi 




00510 


; IF CLOAO TOKEN IS FOUND, EXECUTE CLOAD PROCESS, BUT 




00520 


; FIRST 


INTERCEPT KEYBOARD SCAN [CRUDE WAY OF DOING IT) 




00530 


; TO GRAB PROGRAM ON ITS WAY BACK 


TO A READY CONDITION 




00540 


; iimmiunmmmmmmmummmm Until 




00550 


; 








7F28 F1 


00560 


CLOAD 


POP 


AF j 


CLEAR STACK OF AF REG. 


7F29 2A1640 


00570 




LD 


HL,(4016H) J 


GET CURRENT KEYBRD SCAN 


7F2C 22557F 


00580 




LD 


[STORE) ,HL J 


SAVE IT FOR A WHILE 


7F2F 21427F 


00530 




LD 


HL, BYPASS j 


GET VALUE OF ROUTINE 


7F32 221640 


00600 




LD 


[4016H),HL i 


PATCH INTO KEYBRD PLACE 


7F35 21E941 


00610 




LD 


HL.41E9H ; 


POINT TO BUFFER LOC'N 


7F3B 3600 


00620 




LD 


[HL),0D ; 


PLACE END OF LINE CMD. 


7F3A 2B 


00630 




DEC 


HL ; 


BUHP HL BACK TO START 


7F3B 3EB9 


00640 




LD 


A,0B9H ; 


GET CLOAD VALUE 


7F3D D6B0 


00650 




SUB 


BOH ; 


STRIP OFFSET VALUE 


7F3F C3651D 


00660 
00670 




JP 


1D65H ; 


BACK TO EXECUTION ROUT. 




00680 


; mmm ## immmmmmimmmm, ##«*#*###*# 




00690 


; CLOAD 


ABOVE WILL EXECUTE, RESET 


THE STACK, AND ATTEMPT 




00700 


; TO RETURN TO 


A READY CONDITION. 


AT THIS POINT, THE 




00710 


i KEYBOARD DRIVER INTERCEPT WILL 


REDIRECT THE PROCESSOR 




00720 


J TO THE BYPASS ROUTINE BELOW, WHICH WILL AGAIN SET UP 




00730 


; THE BUFFEB, I 


1EPATCH THE KEYBOARD DRIVER, AND RUN. 




00740 


; ummmmmmtmumtmmmmmmtmm 




00750 


; 








7F42 2A557F 


00760 


BYPASS 


LD 


HL, [STORE) ; 


GET BACK KEYBRD SCAN 


7F45 221640 


00770 




LD 


(4016H),HL ; 


PUT BACK INTO PLACE 


7F48 21EB41 


00780 




LD 


HL.41EBH ; 


GET BUFFER LOCATION 


7F4B 368E 


00790 




LD 


IHLl.BEH i 


GET RUN COMMAND TOKEN 


7F40 23 


00800 




INC 


HL ; 


BUMP UP BUFFER POS'N 


7F4E 3600 


00810 




LD 


(HL).OO ; 


CLOSE OFF THE BUFFER 


7F50 2B 


00820 




DEC 


HL ; 


BUMP BACK IN BUFFER... 


7F51 2B 


00830 




DEC 


HL ; 


...TO THE RUN COMMAND 


7F52 C35A1D 


00840 
00850 




JP 


105AH ; 


AND THEN EXECUTE IT 




00860 


; mmmmt if mmmmmmmmmt tummm 




00B70 


; THE FOLLOWING FOUR BYTES ARE TEMPORARY KEYBOARD STORAGE 




00B80 


; mmmmmmtmmmmmummmmmim 




00890 


j 








7F55 0000 


00900 


STORE 


DEFW 


0000 ; 


TEMPORARY TWO-BYTE AREA 


7F57 C3 


00910 


AWAY 


DEFB 


0C3H ; 


JUMP COMMAND IN PLACE 


7F58 781 D 


00920 
00930 


RETURN 


OEFW 


1D78H ; 


ORIGINAL VALUE CHANGES 


7F00 


00940 




END 


START J 


PATCH ROUTINE AT START 


00000 TOTAL ERRORS 










31717 TEXT AREA BYTES LEFT 








AWAY 7F6; 


' 00910 


00360 


00480 






BYPASS 7F42 0U760 


00580 








BYTE 1D7B 00140 


U042C 








CLQAD 7FEE 


I 00560 


U04SC 








ENTRY 7FUf 


: 0U290 


U021C 








NOTRDY 7F1S 


i 00350 


0032C 








RETURN 7FSfc 


I 0U92O 


00200 








START 7F0U 0U190 


00B40 








STORE 7FS!i 00900 


00580 


00760 







Autoexecute BASIC Programs 

One of the pleasures of disk operating systems 
is the ability to load and run programs 
automatically. This can be done with tape 
systems as well, simply because all the Level II 
BASIC operations are organized as subroutines. 
Any one may be called at any time. To 
autoexecute a program, then: 

1. The SYSTEM command must be entered 
and the load begun in this mode. 

2. The SYSTEM tape must load over its 
own return point so that it can begin 
execution automatically. 

3. The SYSTEM program loaded must 
CALL the CLOAD routine, first preparing 
the stack to return to itself instead of 
command level. 

4. Upon return, the SYSTEM program must 
prepare the stack once again for return to 
normal Level II operation, and jump to the 
RUN routine. 

The process is straightforward with one 
exception: the CLOAD routine is terminal. That 
is, it forces a return to command level upon 
completion by clearing out the return address on 
the stack. It means that a program which might 
have been written in little more than a dozen 
bytes must instead play some memory hopscotch 
first. 

Before turning to this loading routine itself, 
here is a look at the heart of the autorun sequence 
itself - a mere thirteen bytes! Enter any short 
BASIC program first, then the routine below: 



5000 


21 EB 


41 


LD 


HL.41EB 


5003 


36 BE 




LD 


(HLJ.BE 


5005 


23 




INC 


HL 


5006 


36 00 




LO 


(HL) ,00 


5008 


2B 




DEC 


HL 


5009 


2B 




DEC 


HL 


5D0A 


C3 5A 


1D 


JP 


1D5A 



From BASIC, you can put this program in 
place with the following lines from command 
level: 



X=204B0 : P0KEX.33 : P0KEX+1 ,232 : POKEX+2,65 : 
POKEX+3,54 : POKEX+4,241 : POKEX+5,35 : POKEX+6,54 

POKEX+7,0 : P0KEX+B.43 : POKEX+9,43 : POKEX+10,195 
POKEX+11,80 : POKEX+12,29 <ENTER>. 



This simple routine sets the HL register to 
point to the usual beginning of the keyboard 
input buffer, puts an 8E (the RUN command 
value) into that place, bumps the register one 
place forward, and puts a zero there. The HL 
register is bumped back to just before the 
beginning of the keyboard buffer, and the 
execution routine at 1D5A is entered. 
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00100 


; itmmmtmmmmmmmmmmmmtmm 






00110 


; MINIATURE MACHINE-LANGUAGE MONITOR DISPLAYING HEX/ASCII 






00120 


; mmttmmimmmimmmmtmmimmmt 


06CC 




00130 


READY 


EQU 


06CCH 


RETURN TO READY INTACT 


1D78 




00140 


BYTE 


EQU 


1D7BH 


ROM READ KEY & TOKENIZE 


1997 




00150 


3YNERR 


EQU 


1997H 


ENTRY POINT TO SN ERROR 






0016D 


; it i in utt it in it tm ii it mi ti minimi in in ii in it 






00170 


; GET REST OF DATA AN0 CONVERT 




0000 


CD7810 


00180 


OPENER 


CALL 


BYTE 


NEXT CHARACTER IN LINE 


0003 


FE22 


00190 




CP 


22H 


IS IT A QUOTE MARK? 


0005 


C29719 


00200 




JP 


NZ.SYNERR 


OUT TO ERROR IF NOT 


0008 


ES 


00210 




PUSH 


HL 


SAVE LINE POINTER 


0009 


FDE1 


00220 




POP 


IY 


STASH POINTER IN IY 


000B 


CDFBOO 


00230 




CALL 


XX99 


CONVERT CHARS TO HEX 


000E 


C0C901 


00240 




CALL 


01C9H 


CLEAR SCREEN (ROM CALL) 


0011 


184C 


00250 




JR 


NEXT99 


JUMP PAST SUBROUTINES 






00260 


; umtmmm 






00270 


; GET 16 SCREEN 


POSITIONS READY 


10H) 


0013 


7A 


00280 


CONTNT 


L0 


A,D 


GET ADDRESS LOW BYTE 


0014 


21403C 


00290 




LD 


HL.3C40H 


GET SECOND SCREEN LINE 


0017 


E6F0 


00300 




AND 


OFOH 


MASK OUT LOW BITS 


0019 


C0E200 


00310 




CALL 


HRRRS 


ROTATE/DISPLAY ROUTINE 


001C 


7A 


00320 




LD 


A,D 


GET ADDRESS LOW BYTE 


001D 


E6 0F 


00330 




AND 


OFH 


MASK OUT HI6H BITS 


001F 


C0D800 


00340 




CALL 


HEXASC 


CONVERT WORKS TO ASCII 


0022 


77 


00350 




LD 


(HL) ,A 


DISPLAY THE CHARACTER 


0023 


23 


00360 




INC 


HL 


NEXT SCREEN POSITION 


0024 


7B 


00370 




LD 


A,E 


SET HIGH BYTE 


0025 


E6F0 


00380 




AND 


OFOH 


MASK OUT LOW BITS 


0027 


CDE200 


00390 




CALL 


RRRRS 


ROTATE/DISPLAY ROUTINE 


Q02A 


78 


00400 




LD 


A,E 


GET HIGH BYTE AGAIN 


002B 


EEOF 


00410 




AND 


OFH 


MASK OUT LOW BITS 


002D 


CDD800 


00420 




CALL 


HEXASC 


CONVERT HEX TO ASCII 


0030 


77 


00430 




LD 


[HL) ,A 


DISPLAY THE CHARACTER 


0031 


21B03C 


00440 




LD 


HL.3C80H 


GET NEXT SCREEN ROW 


0034 


0610 


00450 




LD 


B.10H 


GET 16 VALUE INTO B 






0D460 


i mmmmmmmmmmi 


mtmmmummm 






00470 


; DISPLAY CONTENTS OF ADDRESS CHOSEN 


0036 


1A 


00480 


C0NT02 


LD 


A, (DE) 


GET VALUE AT ADDRESS 


0037 


E6F0 


00490 




AND 


OFOH 


MASK OUT HIGH BITS 


0039 


CDE200 


00500 




CALL 


RRRRS 


CONVERT/DISPLAY ROUTINE 


003C 


1A 


0051 




LD 


A,(DE) 


GET VALUE AT ADORESS 


003D 


EEOF 


00520 




AND 


OFH 


MASK OUT LOW BITS 


003F 


CDDBOO 


00530 




CALL 


HEXASC 


CONVERT CHAR TO ASCII 


0042 


77 


00540 




LD 


[HL) ,A 


DISPLAY THE CHARACTER 


0043 


23 


00550 




INC 


HL 


GET NEXT SCREEN POSN. 


0044 


23 


00560 




INC 


HL 


GO ONE PLACE MORE 


0045 


13 


00570 




INC 


OE 


GET NEXT ADORESS LOCN . 


0046 


10EE 


00560 




DJNZ 


C0NT02 


FULL 16 BYTES DISPLAYED 






00590 


; iimmmmi 


mmmmmmmm 






00600 


; DISPLAY ASCII 


VALUES TOO 




0048 


0610 


00610 




LD 


B.10H 


GET 16 TIMES IN B REG. 


004A 


48 


00620 




LD 


C,B 


SAVE IT IN C FOR USE 


004B 


18 


00630 




DEC 


DE 


GET NEXT LOWEST ADDRESS 


004C 


10FD 


00640 




DJNZ 


$-1 


DECREMENT BACK TO START 


004E 


41 


00650 




LD 


B,C 


GET 1B TIMES IN B AGAIN 


004F 


21C03C 


00660 




LD 


HL.3CC0H 


GET NEXT LINE OF SCREEN 


0052 


1A 


0D670 


BBBA 


LD 


A, IDE) 


GET CONTENTS OF ADDRESS 


0053 


77 


0D680 




LD 


(HL) ,A 


DISPLAY EXACTLY AS IS 


0054 


23 


00690 




INC 


HL 


SET NEXT SCREEN LOCN. 


0055 


23 


00700 




INC 


HL 


SET NEXT AFTER THAT 


0056 


23 


00710 




INC 


HL 


VISUALLY MATCHES HEX 


0057 


13 


00720 




INC 


DE 


GET NEXT ADDRESS TO SEE 


0058 


10FB 


0730 




DJNZ 


BBBA 


DO IT FOR 16 ADDRESSES 


005A 


41 


07 40 




LD 


B,C 


GET 16 INTO B AGAIN 


0058 


18 


U075U 




DEC 


DE 


GO BACK TO PREVIOUS 


005C 


10FD 


00760 




DJNZ 


»-1 


AND BACK TO BEGINNING 


005E 


C9 


00770 




RET 




DONE WITH DISPLAY ROUT. 






007 80 


; mim 


iimmmmmmttm 






00790 


; SCAN 


KEYBOARD 


FOR EDIT SEQUENC 




005F 


CD1300 


00800 


NEXT99 


CALL 


CONTNT 


FIND WHICH KEYS PRESSED 






00B1D 


; nmmmmmmimmm 


mmmmmmmm 






00820 


; SCAN 


KEYBOARD 


FOR BREAK, ARROW 




0062 


3A403B 


00830 


EDITOR 


LD 


A,(3840H) 


GET BREAK, ARROWS ROW 


0065 


FE04 


00840 




CP 


4 


IS IT BREAK KEY? 


0067 


2006 


00850 




JR 


NZ, ARROW 


IF NOT TEST FOR ARROW 


0069 


F0E5 


00860 




PUSH 


IY 


ELSE RETRIEVE LINE PTR. 


0O6B 


E1 


00B70 




POP 


HL 


SWITCH BACK INTO HL 


006C 


C3CC0E 


00880 




JP 


READY 


BACK TO BASIC READY 


006F 


FE10 


00890 


ARROW 


CP 


10H 


BEGIN ARROW COMPARES 


0071 


2007 


00900 




JR 


NZ,AAAA 


GO IF NOT DOWN ARROW 


0073 


0610 


0091 




LD 


8.10H 


GET B READY WITH 16 


0075 


1B 


00920 




DEC 


DE 


GO BACK IN MEMORY 


0076 


10FD 


0093 




DJNZ 


»-1 


DO IT FOR 16 TIMES 


0078 


1B4B 


00940 




JR 


STNDRD 


DONE NOW; 60 OUT 


007A 


FE08 


00950 


AAAA 


CP 


B 


CHECK IF UP ARROW 


007C 


2007 


00960 




JR 


NZ ,AAAB 


GO OUT IF NOT UP ARROW 


007E 


0610 


00970 




LD 


B.10H 


GET 16 PLACES READY 


0080 


13 


09 80 




INC 


DE 


GET NEXT MEMORY LOCN. 


0081 


10FD 


00990 




DJNZ 


«-1 


DO IT 16 TIMES IN ALL 


ooas 


1840 


01000 




JR 


STNDRD 


DONE NOW; GO OUT 


0085 


FE20 


01010 


AAAB 


CP 


20H 


CHECK IF LEFT ARROW 


0087 


2003 


01020 




Jfl 


NZ.AAAC 


GO OUT IF NOT LEFT 


0089 


1B 


01030 




DEC 


OE 


GET PREVIOUS MEM. LOCN. 


008A 


1839 


01040 




JR 


STNDRD 


DONE NOW; GO OUT 


008C 


FE40 


01050 


AAAC 


CP 


40H 


CHECK IF RIGHT ARROW 


008E 


2003 


01 060 




JR 


NZ.AAAD 


GO OUT IF NOT RIGHT 


0090 


13 


01070 




INC 


DE 


GET NEXT MEMORY LOCN. 


0091 


183 2 


01 080 




JR 


STNDRD 


DONE NOW; GO OUT 






01090 


; mmmmmmmmmm 


mmmmmmmm 






01100 


; GET FIFTH LINE OF SCREEN AND D] 


SPLAY CHOSEN EDITING 
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The routine at 1D5A bumps the HL register 
forward, evaluates the byte (finding 8E = RUN), 
then looks for a possible line number to execute. 
Finding a zero means the command ends there, 
and so a simple RUN routine is entered. Here's 
how to try it out once you have it in place: 



SYSTEM 
/204B0 



<ENTEfl> 
<ENTER> 



The BASIC program you had entered earlier 
should now run just as any other BASIC program 
might. So the idea is to make this autorun 
routine the heart of the area that the CLOAD 
might make its way back to. 

Listing 3-(?) presents a machine language 
program which must precede any program to be 
autoexecuted. It follows the rules above by 
taking over control of the computer, placing a 
patch into the keyboard scan in order to 
intercept the terminal CLOAD routine's return 
to BASIC, and directing the computer to the 
usual CLOAD routine. When CLOAD gets back 
into BASIC, it will present a 'READY' and begin 
to scan the keyboard. It will, however, never get 
there. 

Instead, the intercept now patched in place 
will redirect the computer to a short routine also 

present in the keyboard input buffer area. This 
routine restores the original plundered keyboard 
return address, and executes the automatic RUN 
routine. The autoload remnants in the keyboard 
buffer are no longer needed, and will be wiped 
out at the next keyboard input of any kind. 

To use this program, assemble it and save it at 
the beginning of each in a batch of tapes. Use 
these tapes to CSAVE any programs you wish to 
autoexecute. Whenever you wish to run one of 
these programs, type . . . 



>SYSTEH 
•? AUTO 



<ENTER> 
<ENTER> 



. . . and the program will load, acting as if a 
normal CLOAD were in action, but immediately 
beginning execution of the BASIC routine. 



Machine Language Monitor 

It- can be very frustrating when you need to 
make some quick alterations to memory, or when 
you need to install a short machine language 
program. The options are few: load a 
decimal-to-hex conversion program and enter 
the code; convert the values to hex by hand and 
POKE them in place; write the code into a short 



Undoing NEW 



Continued Listing 



0093 210030 


01110 AAAO 


LD 


HL.3D00H 


FIFTH LINE ON SCREEN 


0096 365F 


01120 


LD 


(HL) ,5FH 


GET CURSOR CHARACTER 


009B S3 


01130 


INC 


HL 


NEXT SCREEN LOCATION 


0099 365F 


01140 


LO 


IHL) ,5FH 


GET CURSOR CHARACTER 


0098 SB 


01150 


DEC 


HL 


BACK TO FIRST LOCN . 


009C 0602 


01160 


LD 


B,2 


GET 2 TRIES INTO B 


009E D5 


01170 AAAE 


PUSH 


DE 


SAVE MEMORY LOCATION 


00BF E5 


01180 


PUSH 


HL 


SAVE SCREEN LOCATION 


00A0 CD4900 


01190 


CALL 


D049H 


BASIC'S KEYBOARD SCAN 


0DA3 El 


01200 


POP 


HL 


RESTORE SCREEN LOCN. 


00A4 01 


01210 


POP 


DE 


RESTORE MEMORY LOCN. 


00A5 FE47 


01220 


CP 


47H 


CHECK IF ALPHA HEX 


00A7 3DB9 


0123 


JR 


NC, EDITOR 


GO OUT IF NOT ALPHA HEX 


00A9 FE30 


01240 


CP 


30H 


CHECK IF NUMERIC HEX 


OOAB 3BB5 


01250 


JB 


C, EDITOR 


OUT IF NOT NUMERIC HEX 


OOAD FE3A 


01260 


CP 


3AH 


CHECK IF OV NUMERIC 


OOAF 3804 


0127 


JR 


C.AAAF 


CHECK NEXT IF IN RANGE 


00B1 FE40 


01280 


CP 


40 H 


CHECK IF OV ALPHAHEX 


00B3 3BA0 


01290 


JR 


C, EDITOR 


OUT IF OV ALPHA HEX 


00B5 77 


01300 AAAF 


LD 


(HL) ,A 


PLACE CHAR ON SCREEN 


00B6 23 


01310 


INC 


HL 


GET NEXT SCREEN LOCN. 


00B7 10E5 


01320 


DJNZ 


AAAE 


GO GET ANOTHER CHAR. 




01330 ; tUtf»tttttHtttiHtlHtttmHttHHIIIHtHttiHttHt 




01340 ; CONVERT CHOSEN DATA TO HEX 




0089 2B 


01350 


DEC 


HL 




OOBA CDCO00 


01360 


CALL 


ASCHEX 




OOBU 4F 


01370 


LO 


C,A 




OOBE 2B 


013B0 


DEC 


HL 




OOBF COECOO 


01390 


CALL 


LLLLS 




0OC2 B1 


01400 
01410 ; 


ADD 


A,C 






01420 i PUT NEW BYTE 


IN PLACE 




00C3 12 


0143 


LD 


IDE) ,A 




00C4 13 


01440 
01450 ; 


INC 


DE 






01460 ; DISPLAY REVISED LINE OF DATA 




00C5 CD1300 


01470 STNDRD 


CALL 


CONTNT 




00C8 CDF400 


01480 


CALL 


DELAY 




DOCB 1895 


01490 
01500 ; 


JR 


EDITOR 






01510 i ASCII 


TO HEXADECIMAL CONVER 


OOCD 7E 


01520 ASCHEX 


LO 


A, IHL) 




OOCE FE40 


01530 


CP 


40H 




OODO 3003 


01540 


JR 


NC,NEXT98 




00D2 0630 


01550 


SUB 


3 OH 




0004 C9 


0156 


RET 






0005 0637 


01570 NEXT98 


SUB 


37H 




00D7 C9 


01580 
01590 ; 


RET 








01600 ; HEXADECIMAL 


TO ASCII CONVERSION 


OOOB FEOA 


01610 HEXASC 


CP 


OAH 




OODA 3003 


01620 


JR 


NC.NEXT96 




OODC C630 


01630 


ADD 


A, 3 OH 




OOOE C9 


01640 


RET 






OODF C637 


01650 NEXT96 


ADD 


A,37H 




00E1 C9 


01660 
01670 ; 


RET 








01690 i RIGHT 


ROTATES 1 R CONVER 




00E2 OF 


01690 RRRRS 


RRCA 






00E3 OF 


01700 


RRCA 






00E4 OF 


01710 


RRCA 






00E5 OF 


01720 


RRCA 






00E6 CDD800 


01730 


CALL 


HEXASC 




00E9 77 


01740 


LO 


(HL) ,A 




OOEA 23 


01750 


INC 


HL 




OOEB C9 


01760 
01770 ; 


RET 








01790 ; LEFT 


ROTATES 


FOR CONVERSION 




OOEC CDCDOO 


01790 LLLLS 


CALL 


ASCHEX 




OOEF 07 


01800 


RLCA 






OOFO 07 


01B1 


RLCA 






00F1 07 


01B20 


RLCA 






00F2 07 


01B30 


RLCA 






00F3 C9 


01840 
01850 ; 


RET 








01860 ; DELAY FOR SCREEN DISPLAYS 




00F4 010020 


01870 DELAY 


LD 


8C.2000H 




00F7 CD6000 


01880 


CALL 


0060H 




OOFA C9 


01B90 
01900 ; 


RET 








01910 i GET/CONVERT 


ASCII FROM BUFFER 






01920 ; TO HEXADECIMAL ADDRESS 




OOFB 0604 


01930 XX98 


LD 


B,4 




OOFD CD791D 


01940 SSSS 


CALL 


BYTE 




0100 F5 


01950 


PUSH 


AF 




0101 10FA 


01960 


DJNZ 


SSSS 




0103 F1 


01970 


POP 


AF 




0104 77 


019BO 


LD 


(HL) ,A 




0105 CDCOOO 


01990 


CALL 


ASCHEX 




010B 5F 


02000 


LD 


E.A 




0109 F1 


02010 


POP 


AF 




01 OA 77 


02020 


LD 


(HL) ,A 




010B COECOO 


02030 


CALL 


LLLLS 




010E B3 


02040 


ADD 


A,E 




01 OF 5F 


02050 


LD 


E.A 




0110 F1 


02060 


POP 


AF 




0111 77 


02070 


LD 


(HL) ,A 




0112 CDCDOO 


02080 


CALL 


ASCHEX 




0115 57 


02080 


LD 


D,A 




0116 F1 


02100 


POP 


AF 




0117 77 


02110 


LD 


(HL) ,A 


Listing Continued . . 



BASIC program that does the work. None of 
these are satisfactory. Ideally, a machine 
language monitor is the tool to use. 

But there are disadvantages to the monitors 
currently available. Many are too long, and are 
part of other, lengthier programs. Others overlap 
resident BASIC programs. And none make 
available ASCII representations as well as 
BASIC graphics characters. The short monitor 
presented in this section provides the latter, can 
be executed from BASIC (using the patch table 
presented earlier), and sits wherever in memory 
you would like. 

It consists of a few major sections: The first 
clears the display, presents the requested 
address, displays the hex contents of that 
address and the sixteen following, displays the 
ASCII or graphics values of that address and the 
sixteen following, and presents a cursor for hex 
code entry. The second section searches the 
keyboard for a valid hex character, displays the 
character, waits for another, displays that, and 
advances the address and display. 

The second section also searches the keyboard 
for the arrows, and advances the display (a) one 
place forward on a right arrow; (b) one place back 
on a left arrow; (c) sixteen places forward on an 
up arrow; and (d) sixteen places back on a down 
arrow. Last of all it searches for the (BREAK) 
key, which returns it to BASIC. 

This monitor, as with all the BASIC-transparent 
programs presented in this book, must be 
executed by using the special command patch 
table (see Listing (?)-(?)). The command used in 
this table is /OPEN'NNNN' - , where NNNN is the 
address to be opened for examination (in hex). 



Undoing NEW 

This is a much easier task than the Level II 
manual would have you believe. When the NEW 
command is entered, the program remains in 
place, completely unchanged! The only 
alteration is that the end-of-B ASIC -program 
pointer in memory has been changed to the 
beginning of the program. Hence, the computer 
believes that the program has a total length of 
zero. 

But the old end-of-program information is still 
intact elsewhere, and can be found very easily. In 
fact, to restore a program you have actually 
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Resetting MEMORY SIZE? 



Continued Listing 



0118 CDEC00 


02120 




CALL LLLLS 


011B 82 




02130 




ADO A,0 


011C 57 




02140 




LD D,A 


D11D C9 




021 SO 




RET 


06CC 




02160 




END READY 


00000 TOTAL ERRORS 






AAAA 


Q07A 


00950 


00900 




MAS 


0085 


01010 


00960 




MAC 


ODBC 


01050 


01020 




AMD 


0093 


01110 


01060 




AAAE 


009E 


01170 


01320 




AAAF 


00B5 


01300 


01270 




ARROW 


006F 


00890 


U085CJ 




ASCHEX 


OOCD 


01520 


01360 


01790 01930 02080 


BBBA 


0052 


00670 


00730 




BYTE 


1D78 


00140 


00180 


01340 


C0NT02 


0036 


00480 


00580 




CONTNT 


0013 


00280 


00800 


01470 


DELAY 


Q0F4 


01870 


01480 




EDITOR 


0062 


00830 


01230 


01250 01280 01490 


HEXASC 


DUDS 


01610 


00340 


00420 00530 01730 


LLLLS 


OOEC 


01730 


U1390 


02030 02120 


HEXT96 


OOOF 


01650 


01620 




NEXT9B 


00D5 


01570 


01540 




NEXT99 


00 5F 


oue oo 


00250 




OPENER 


0000 


001 BO 






READY 


06CC 


00130 


008 BO 


02160 


RRRHS 


00E2 


01690 


00310 


00390 00500 


SSSS 


OOFD 


01940 


01960 




BTNDRD 


00C5 


01470 


00940 


01000 01040 01080 


SYNERR 


1997 


00150 


00200 




XXS9 


OOFB 


01930 


00230 





wiped out, you need to invoke a few ROM 
routines and restore the beginning-of-program 
pointer. 

Although variables are cleared in this process, 
the program is totally restored. If you wish to 
make this a part of a transparent operating system 
using the interpreter patch presented earlier in 
this chapter, Listing 3-(?) presents a complete 
routine. Enter /NEW, and the lost program 
reappears. 

One warning is in order: if before restoring the 
program you cause a ?SN ERROR, the computer 
will jumble up the first part of the program, mess 
around with some other memory pointers, and 
the program will really be lost. 



00100 
00110 
00120 
00130 
00140 
0D150 
00160 
0D170 
00180 
00190 
00200 
00210 

0000 ED5BA440 00220 

0004 3EFF 

0006 12 

0007 C0FC1A 



0000 

00000 TOTAL ERRORS 
RENEW 0000 00220 



iiiimtm mi miiiittmmiimimmti milium 

ONLY A SHORT ROOTINE IS NECESSARY TO DETERMINE WHERE 
A BASIC PROSRAM WAS BEFORE ITS POINTERS WERE RESET. THE 
BEGINNING OF PROGRAM POINTER MOST BE RESET, THE LINE 
NOMBERS RON THOOGH, THE END OF PROGRAM POINTER RESET, 
THE STACK POINTER RESET, THE SCREEN CLEARED, AND THE 
CLEAR (RESET VARIABLES ANO PROGRAM CONDITIONS) EXECUTED 

timmmmimmiimmiiitimimtmitiiiimi 

NOTE THAT THIS ROUTINE IS ALSO CALLED FROM BASIC USING 
THE FORMAT /NEW. THE CUSTOM INTERPRETER IS EMPLOYED. 

itmimimiiiimmmmimmmiiiimmittm 



00230 
00240 
00250 
00260 
00270 
280 



000A 23 

000B 22FB40 

000E ED7BE840 00290 

0012 CDC901 0030D 

0015 C0611B 

0019 C3CC06 



00310 
00320 
00330 
00340 
0035D 



LD DE,(40A4H) 

LO A.OFFH 

LD IDE], A 

CALL 1AFCH 



INC 

LD 

LD 

CALL 

CALL 

JP 



HL 

(40F9H) ,HL 

SP, (40EBH) 

01C9H 

1B61H 

D6CCH 



GET START OF 
GET FF RESETT 
PLACE AT PROG 
GO THRU ALL L 
END OF PRGRM 
HL MOVED JUST 
SIMPLE VARIAB 
RESET STACK T 
CLEAR THE SCR 
CLEAR ALL THE 
BACK TO BASIC 



PRGRM PTR 
ING CODE 
RAM START 
INES TILL 
00 FOUND 

PAST PRGM 
LE POINTER 
NORMAL 
EEN NOW 
POINTERS 
"READY" 



iitimmmtmmmimmtiimmitimimmm 

END 



Resetting MEMORY SIZE? 

The size of BASIC memory available can also 
be changed from BASIC itself, because it too is 
simply stored in a two-byte pointer in the RAM 
patch area. New values may be POKEd into 
place, so long as they meet two conditions: 

1. The new value must be within the range 
of actual memory available. 

2. It must not dip below the top of an 
existing BASIC program already in memory. 

3. If no program is in memory, it must not 
dip below address 4414. 



Here's how to do it. Convert the desired new 
memory size to split decimal with this formula: 



5000 21003C 
5003 11013C 
5006 01FF03 
5009 3620 
500B EDBO 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
0017D 
00180 
001 BO 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 



tttmmitmmitittmmtiummimtimiiiimi 

RAM CHECKING PROGRAM - FIRST VERSION WITHOUT DISPLAY - 
EXHAUSTIVELY CHECKS EACH TRIO OF RAM LOCATIONS WITHOOT 
DISPLAYING CURRENT ADDRESS! BAD ADDRESSES ONLY SHOWN. 

iimimiimmimimmmimiiiimiiiimmm 

NOTE THAT THIS PROGRAM IS • SELF-RELOCATING • AND MUST 
BE ASSEMBLED AT THE ORIGIN ADDRESS SPECIFIED BELOW. 

iiiimimiiiimmitiiimiiiiiiimmmmimm 



5000H 



DO NOT CHANGE ORIGIN I 



iimitmiittmmttmmiHittimmimmmm, 

SUBROUTINE TO CLEAR THE SCREEN WITH NORMAL SPACES 

it mm immi ii mi tm it limn i mm m m it mil 

; BEGINNING OF VIDEO 

i DESTINATION OF SPACE 

; SPACES ON SCREEN 

i DISPLAY BLANK SPACE 

; CLEAR THE SCREEN 

it mm m tm mint mm i mm in m i m,,,,,,,,,, 

SET OP MIDDLE OF PROGRAM POINTER, DISPLAY STAR TO SHOW 
PROGRAM IS WORKING, SET UP THE STACK POINTER IN RELA- 
TIONSHIP TO THE IX REGISTER, AND SPECIFY START OF TEST 

mitmmiHiiiimimmiimiimmmimmm, 



LD 


HL.3C00H 


LD 


DE.3C01H 


LD 


BC.03FFH 


LD 


(HL) ,20,1 


LOIR 
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Listing Continued . 



X ■ NNNNN 


<EWTER> 


Y = FIX [X/256) 


<ENTEfl> 


2 = X - Y • 256 


<ENTEfl> 


PRINT 2,Y 


<ENTER> 



The value of Z is the least significant byte of 
the new memory size, Y is the most significant 
byte. Now: 



POKE 16561 ,Z : POKE 16562, Y : CLEAR50 

The new memory size has been set, and 50 
bytes are cleared for string space, as usual. If you 
haven't followed the rules about legitimate 
memory sizes, expect a fast system crash. 



Chapter 3 



Peek That Keyboard 



Com 


inued L 


isting 

00360 


5000 


DD218050 


00370 


5011 


3AFE3F 


00360 


6014 


EEOA 


00390 


5016 


32FE3F 


00400 


5019 


00F9 


0041 


501 B 


067F 


00420 


5010 


33 


00430 


501 E 


10FD 


00440 


5020 


210060 


00450 
00460 
00470 
00460 
00490 
00500 
00510 
00520 
0053 


50 23 


AF 


00540 


5024 


77 


00550 


5025 


4F 


00560 


5026 


FS 


00570 


5027 


79 


00580 


5026 


77 


00590 


5029 


23 


00600 


502A 


70 


00610 


S02B 


FE80 


00620 
00630 
00640 

00650 


502D 


2830 


00660 


502F 


E5 


00670 


5030 


00E5 


00680 


5032 


El 


00690 


5033 


BC 


00700 


5034 


2629 


00710 


5036 


E1 


00720 


5037 


F1 


00730 


5036 


77 


007 40 


5039 


2B 


00750 


503A 


2B 


00760 


5036 


77 


00770 


5030 


47 


007 80 


503D 


76 


007 90 


503E 


B8 


00800 


503F 


2805 


00610 


5041 


161B 


00620 


5043 


05 


00630 


5044 


181B 


00840 


5046 


23 


00650 


5047 


23 


00660 


5046 


7E 


00670 


5049 


BB 


00880 


504A 


260 5 


00890 


504C 


1610 


00900 


504E 


05 


00910 


504F 


1810 


00920 


5051 


Eg 


00930 


5052 


34 


00940 


5053 


OC 


00950 


5054 


7E 


00960 


5055 


47 


00970 


5056 


FEOO 


00980 


5056 


20CC 


00990 


505A 


23 


01000 


5056 


0E00 


01010 


5050 


18C7 


01020 


505F 


1664 


01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
01110 


5061 


7C 


01120 


5062 


E6F0 


01130 


5064 


OF 


01140 


5065 


OF 


01150 


5066 


OF 


01160 


5067 


OF 


01170 


5066 


1622 


01180 


506A 


1622 


01190 


506C 


7C 


01200 


506D 


E60F 


01210 


506F 


1616 


01220 


5071 


1616 


01230 


5073 


7D 


01240 


507 4 


E6F0 


01250 


5076 


OF 


0126 


5077 


OF 


01270 


5078 


OF 


01280 


5079 


OF 


01290 


607A 


1610 


01300 


507C 


1610 


01310 


507E 


7D 


01320 


507F 


E60F 


01330 


5081 


1609 


01340 


5083 


1609 


01350 


5085 


D1 


01360 


5086 


3ED3 


01370 



LD 


IX.50B0H 


LD 


A,(3FFEH) 


XOB 


OAH 


LD 


(3FFEH) ,A 


LD 


SP.IX 


LD 


B.7FH 


INC 


SP 


DJNZ 


»-1 


LD 


HL.6000H 



MIDDLE OF TEST PROGRAM 
BOTTOM RIGHT OF SCREEN 
ALTERNATE SPACE & STAR 
DISPLAY IT ON SCREEN 
START STACK POINTER 
NUMBER OF MOVES FOR SP 
SP = SP + 1 
DO IT 127 TIMES 
BEGINNING OF TEST AREA 



mtimmmmmtmmmmmmmttmtmtm 

TEST BEGINS WITH THE VALUE OF ZERO, AND PROCEEDS TO 
VALUE FF. EACH VALUE IS WRITTEN IN TURN TO EACH OF A 
TRIO OF MEMORY LOCATIONS IN ORDER TO DETERMINE THEIR 
EFFECT ON EACH OTHER AS VALID ELECTRONIC STORAGE CELLS. 
ttltHmHtllHttlttlHHiHUIHHHftttHimfHIHt 



CLEAR ACCUMULATOR 
PLACE VALUE IN MEMORY 
PLACE VALUE IN C 
SAVE VALUE IN ACCUM. 
GET VALUE FROM C 
PLACE VALUE IN MEMORY 
INCREMENT TO NEXT MEM 
GET MSB OF ADDRESS 
IS HEM AT BOOO YET? 
NOTE THAT THE VALUE 
ABOVE IS FOR 16K 
CO FOR 32K, ETTfOR 48K 
IF SO, THEN 



XOH 


A 


LD 


IHL) ,A 


LD 


C,A 


PUSH 


AF 


LD 


A,C 


LD 


(HL) ,A 


INC 


HL 


LD 


A,H^-- 




^fflJH 


C9 


£><2>M 


JR 


Z,»+32H 


PUSH 


HL 


PUSH 


IX 


POP 


HL 


CP 


H 


JR 


Z,»+26H 


POP 


HL 


POP 


AF 


LD 


(HL) ,A 


DEC 


ML 


DEC 


HL 


LD 


IHL) ,A 


LD 


B,A 


LD 


A, [HL) 


CP 


B 


JH 


Z,»+7 


LD 


D.1BH 


PUSH 


DE 


JR 


» + 1DH 


INC 


HL 


INC 


HL 


LO 


A,(HL) 


CP 


B 


JR 


Z,»+7 


LD 


D.10H 


PUSH 


OE 


JR 


1 + 1 BH 


DEC 


HL 


INC 


(HL) 


INC 


C 


LD 


A,(HL) 


LD 


B,A 


CP 


00 


JR 


NZ ,I-32H 


INC 


HL 


LD 


0,0 


JR 


I-37H 


JR 


S + 66H 



ELOCATE 
SAVE MEMORY VALUE 
SAVE MIDDLE DF PROGRAM 
GET POSITION INTO HL 
CHECK AGAINST 80 VALUE 
RELOCATE IF DONE 
RESTORE ORIGINAL VALUE 
RESTORE ORIGINAL TEST 
PUT VALUE INTO MEMORY 
BACK TO ORIGINAL LOC'N 
BACK TO ONE BEFORE IT 
PUT VALUE INTO MEMORY 
SAVE VALUE IN B REG. 
GET VALUE AT LOC'N HL 
CHECK AGAINST B VALUE 
GO ON IF IT CHECKS OKAY 
GET VALUE OF REL. SUB. 
SAVE VALUE ON STACK 
JUMP TO SUBROUTINE 
GET ORIGINAL TEST POS'N 
GO ONE 6EY0ND IT 
GET VALUE AT THAT POS'N 
CHECK AGAINST 6 REG. 
GO ON IF MEMORY OKAY 
GET JUMP FOR REL. SUB. 
SAVE VALUE ON STACK 
JUMP TO SUBROUTINE 
BACK TO ORIGINAL POS'N 
INCREMENT VALUE IN MEM 
INCREMENT TEST VALUE 
GET VALUE IN MEMORY 
SAVE VALUE IN B REG. 
CHECK IF 256 BYTES DONE 
LOOP SACK ANO CONTINUE 
GET NEXT MEMORY VALUE 
RESET TEST VALUE TO 
LOOP BACK FOR NEXT TEST 
REL.SU6. STEPPING STONE 



ttmmmmmiiiiimmmmtmmtmtmmm 

SUBROUTINE BELOW IS ENTERED WHEN A BAD MEMORY LOCATION 
HAS BEEN DETERMINED. IT CONVERTS HEX VALUES TO ASCII 
AND DISPLAYS THEM ON THE SCREEN. NOTE THE RELATIVE 
SUBROUTINE ENTRY AND EXIT METHOD USING THE D REGISTER. 

iittmtttiiimtimtmmmmmmmimitmm 



GET VALUE FROM H REG. 
HASK OFF LOW BITS 
ROTATE RIGHT FOR CONV. 

.... SOME MORE 

.... AND SOME MORE 

UNTIL IT'S DONE. 

GET VALUE FOR REL. SUB. 
AND JUMP TO SUBROUTINE 
GET VALUE FROM H REG. 
MASK OUT HIGH BITS 
GET VALUE FOR REL. SUB. 
AND JUMP TO SUBROUTINE 
GET VALUE FROM L. REG. 
MASK OUT LOW BITS 
ROTATE FOR CONVERSION 

.... SOME MORE 

SOME MORE 

ANO IT'S DONE. 

GET VALUE FOR REL. SUB. 
AND JUMP TO SUBROUTINE 
GET VALUE FROM L REG. 
HASK OUT HIGH BITS 
GET VALUE FOR REL. SUB. 
ANO JUMP TO SUBROUTINE 
RESTORE VALUE TO DE 
G ET RETU RN POS'N VALUE 

Listing Continued . . . 



LD 


A,H 


AND 


OFOH 


RRCA 




RRCA 




RRCA 




RRCA 




LD 


D.22H 


JR 


J+24H 


LO 


A,H 


ANO 


OFH 


LD 


D.1BH 


JR 


»+1DH 


LD 


A,L 


AND 


OFOH 


RRCA 




RRCA 




RRCA 




RRCA 




LD 


D,10H 


JR 


•+12H 


LD 


A,L 


AND 


OFH 


LD 


D,9 


JR 


( + OBH 


POP 


DE 


LD 


A.003H 



Peek that Keyboard 

One of the handiest functions for fast-running, 
convenient BASIC programs is the INKEY$ 
command. This allows the latest keystroke to be 
transferred to a program variable, where it can 
then be evaluated. 

For action games, BASIC word processors and 
other speed-conscious programs, INKEY$ can 
be too long because it requires considerable 
evaluation and juggling of memory space. There 
is a faster way, and it involves examining the 
keyboard's memory contents directly. Below is 
the keyboard matrix: 




You can see that various memory locations 
refer to various rows of keys. Depending on the 
key pressed, different values will be discovered 
by PEEKing. For example, A=PEEK(14400) 
returns a value of 1 if ENTER is pressed, and a 
value of 2 if CLEAR is pressed, 4 if BREAK is 
pressed, 8 for down arrow, 16 for up arrow, 32 for 
left arrow, 64 for right arrow, and 128 for a space. 
If only a few keys are being sought - perhaps the 
arrow in an action game - a very tight loop can be 
constructed that is many times faster than 
INKEY$: 



10 A = PEEKI14400) : IF A«0 THEN 10 
20 IF A=8 THEN 100 : IF A=16 THEN ZOO 
30 IF A=32 THEN 300 IF A=64 THEN 400 
40 GOTO 10 



For top-speed operation, this should all appear 
on one line; try it in comparison with testing for 
CHR$(8) or CHR$(9), etc., etc., to determine the 
arrows. 
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Peek That Keyboard 



Continued 


Listing 


5088 


92 


01380 


5089 


DD770D 


01390 


508C 


18FF 


01400 


S08E 


D5 


01410 


508F 


F5 


01420 


5090 


11003C 


01430 


5093 


1A 


01440 


5094 


FE20 


01450 


509E 


2B03 


01460 


5098 


13 


01470 


5099 


18F8 


01480 


509B 


7B 


01490 


509C 


FE04 


015DD 


509E 


200A 


01 51 


50A0 


3E20 


01520 


50A2 


1B 


0153 


50A3 


1 2 


01540 


50A4 


1E 


01550 


50A5 


12 


0156D 


50AS 


1b 


01570 


50A7 


1 2 


01580 


50A8 


1 B 


01590 


50A9 


1 2 


01600 


50AA 


F1 


01610 


50AB 


FEOA 


01620 


50AD 


3004 


01630 


50AF 


CE30 


01640 


50B1 


1802 


01650 


50 B3 


C637 


01660 


50B5 


12 


01670 
01880 
01 690 
01700 
01710 
01720 


50 B6 


C5 


01730 


50B7 


06FF 


01740 


50B9 


1 OFE 


01750 


50BB 


C1 


01760 


50 BC 


D1 


01770 


50BO 


3EC9 


01780 


50BF 


92 


01790 


50C0 


DD7744 


01800 


50C3 


1BFF 


01810 
01820 
01B30 
01840 
01850 
01860 
01870 
01880 
01890 
01900 


50C5 


DDE5 


01910 


50C7 


0DE5 


01920 


50C9 


E1 


01930 


50CA 


01 


01940 


50CB 


7A 


01950 


50CC 


EE20 


019E0 


50CE 


57 


01970 


50CF 


D5 


01980 


50D0 


0880 


01990 


S0D2 


2B 


02000 


50D3 


IB 


02D10 


50D4 


10FC 


02020 


50D6 


01FF00 


02030 


50D9 


EDBO 


02040 


500B 


DDE1 


02050 


50DD 


3E20 


02060 


50DF 


DDAEA2 


02070 


50E2 


DD77A2 


02080 


50E5 


3EF0 


02090 
02100 
02110 
02120 


50E7 


DOAEAC 


02130 


50EA 


DD77AC 


02140 


50ED 


DDE5 


02150 


50EF 


E1 


02160 


50F0 


2E11 


02170 


50F2 


E9 


02180 
02190 
02200 


5000 




02210 


00000 TOTAL 


ERRORS 



SUBTRACT RETURN DIFF. 
ANO MAKE JR OPERAND 
IRRELEVANT OPERAND 
SAVE VALUE ON STACK 
SAVE VALUE ON STACK 
GET TOP LEFT OF SCREEN 
GET VALUE ON SCREEN 
IS IT A SPACE NOW? 
IF SO, GO AHEAD SOME 
INCREMENT SCREEN POS'N 
AND GO AHEAD PAST TEST 
GET VALUE OF SCREEN 
IS IT 4 POS'NS OVER? 
IF NOT, GO ON AHEAD 
IF SO GET A SPACE READY 

GO BACK SOME 

AND FILL WITH A SPACE 

AND BACK SOME MORE 

AND INSERT ANOTHER ONE 
AND BACK A BIT MORE... . 
AND STASH ANOTHER SPACE 
AND BACK ONE MORE TIME 
AND STUFF A SPACE THERE 
RESTORE VALUE TO AF 
IS VALUE LESS THAN 10? 
IF LESSER, THEN JUMP 
CONVERT HEX TO ASCII 
AND GO ON PAST THE REST 
CONVERT HEX TO ASCII 
AND STASH ON THE SCREEN 



iiitintnttimmiimiiiiiiiimiminnmitimii 

SHORT ROUTINE BELOW USED AS DELAY AFTER LOC'N DISPLAY. 
II tiltlllllllllltltllltltltllllllttltlllllllillttltltll 



SOB 


D 


LD 


(IX+ODH) ,A 


JR 


»+1 


PUSH 


DE 


PUSH 


AF 


LD 


DE.3C00H 


LD 


A, (DEI 


CP 


20H 


JR 


Z, J + 5 


INC 


DE 


JR 


«-6 


LD 


A,E 


CP 


04 


JR 


NZ,»+OCH 


LD 


A.20H 


DEC 


DE 


LD 


(DE) ,A 


DEC 


DE 


LD 


(DE) ,A 


DEC 


DE 


LD 


(DE) ,A 


DEC 


DE 


LD 


(DE) ,A 


POP 


AF 


CP 


OAH 


JB 


NC,»+6 


ADO 


A.30H 


JB 


«+4 


ADO 


A.37H 


LD 


(DE) ,A 



PUSH 


BC 


LD 


B.OFFH 


DJNZ 


»-0 


POP 


BC 


POP 


DE 


LD 


A.0C9H 


SOB 


D 


LD 


(IX+44H) ,A 


JB 


»+1 



SAVE VALUE IN BC REG 
GET DELAY VALUE 
AND DELAY JUST A LITTLE 
RESTORE BC VALUE 
RESTORE DE VALUE 
GET VALUE TO RETURN 
SUBTRACT JUMP OFFSET 
PLACE AS JR OPERAND 
IRRELEVANT OPERAND 



linnnmnnniiiinnniinimniinmiiiniliili 

PROGRAM RELOCATION ROUTINE. HL AND DE REGISTERS ARE 
LOADED FROM THE IX REGISTER, AND MODIFIED BY EXCLUSIVE- 
ORING WITH A KNOWN VALUE IN A. THUS, A NEW PROGRAM 
BEGINNING CAN BE DETERMINED, INTERNAL TEST POSITIONS 
CAN BE MODIFIED, AND THE IX AND SP POINTERS RESET. 
Illttlltllllltltltllttitlllttlltlltlllllllllttlltllllll 



SAVE PROGRAM POSITION 
SAVE PROGRAM POSITION 
TRANSFER TO HL RES. 
TRANSFER TO OE REG. 
GET VALUE FROM D REG. 
TRANSFER TO HIGH MEM. 
PUT BACK IN D RE6. 
AND STASH ON STACK 
DEC. TO PROGRAM START 
AND BEGIN DECREMENTING 
FOR BOTH THE REGISTERS 
UNTIL IT'S ALL DONE 
AND GET READY TRANSFER 
AND THEN DO ITI 
RESTORE NEW VALUE 
VALUE TO MOD. ADDRESSES 
MODIFY IX+A2 ADDRESS 
AND STORE IT IN PLACE 
VALUE TO MOD. ADDRESSES 
CHANGE OPERAND ABOVE TO 
BO FgR 32K MFM TFST AND 



PUSH 


IX 


PUSH 


IX 


POP 


HL 


POP 


DE 


LD 


A,D 


XOB 


20H 


LO 


D,A 


PUSH 


DE 


LD 


8, BOH 


DEC 


HL 


DEC 


DE 


DJNZ 


»-2 


LD 


BC.OOFFH 


LDIR 




PDP 


IX 


LD 


A.20H 


XOH 


IIX+0A2H) 


LD 


(IX+0A2H) ,A 


LD 


A r Q£ftH~£l>- 


_o 


*• /><*>* 


XOR 


(IX+OACH) 


LD 


(IX+OACH) ,A 


PUSH 


IX 


POP 


HL 


LO 


L.11H 


JP 


(HL) 



To WFOR 4BK MEM TES T^ 

MODIFY IX+AC ADDRESS 

AND STORE IT IN PLACE 
STORE THE PROGRAM PTR. 

AND TRANSFER IT TO HL 
SET LSB OF HL REGISTER 
JUMP TO PROGRAM START I 



1 1 ttt n in ttttitiitttiittiiit n tut it t tti until mint 

END 5000H 



There is yet another use for this PEEK 
function. As noted in Chapter 2, location 387F 
reveals if any key is pressed at all. This can be 
used in a BASIC text editor, for example, and is 
much faster than INKEY$ to check for 
keypressing: 

10 A = PEEK114463) : IF A=0 THEN 10 

This is one of the fastest keystroke-detectors 
in BASIC, and from there a group of PEEKs 
could be done, checking the most-used rows of 

characters first. It's both a matter of taste and 
programming skill whether INKEY$ or PEEK is 
used for keyboard input, but in some situations 
(such as testing for carriage returns and other 
control codes), PEEK is the winner. 



DATA: 


1 


2 


JUW1U t 

4 


a 


SJ. 1 1U 

16 


32 


64 


128 


ADDRESS 


















14337 


• 


A 


B 


C 


D 


E 


F 


G 


14338 


H 


I 


J 


K 


L 


M 


N 





14340 


P 





R 


S 


T 


U 


V 


w 


14344 


X 


Y 


Z 












1435E 





1 I 


2 ii 


3 1 


4 $ 


5 % 


6 & 


7 ' 


14368 


8 ( 


9 ) 


; * 


; + 


, < 


- = 


. > 


/ ? 


14400 


ENT 


CLR 


BKR 


UPAR 


DNAR 


LFTAR 


RTAR 


SPACE 


14464 


SHIFT 

















Figure 3-(?) is a chart of all the characters and 

their respective PEEK positions and data 
returned. Remember, when more than one key is 
depressed at a time, the row of the data at that 
address is returned. For example, if PEEK 
(14400) returns 129, then both ENTER and 
SPACE are being held down. This is significant 
because INKEY$ returns only the last character 
pressed, and there is no real way of getting to 
multiple characters. Try this: 



10 A = PEEK (14400) 

20 IF A ■ 128 THEN 100 

30 PRINT "PRESS ENTER AND CLEAR" 

40 GOTO 10 

100 PRINT'OONEI" 



Simple as this may appear, it offers an 'out' for 

programs that need special, unusual input for 
some functions. It can be used as the sort of 
double-interlock protection switch found on 
industrial machinery to keep both hands out of 
blades and moving parts. 

Furthermore, when the keyboard is PEEKed, 
the values returned can be changed and mutated 
at will - for example, a BASIC letter-writer could 
have two easily written routines to make the 
keyboard the standard 'QWERTY' type or 
changing it to the faster Dvorak type. Of course, 
even with PEEK statements, BASIC is not likely 
to keep up with that sort of speed typing! 
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Make-'Em-Sweat Memory Test 

Many memory tests are available for testing 
the dynamic memory in the TRS-80 and 
expansion interface, including the simple test 
done by the computer itself on power-up (see 
Supplement to Chapter 1). Most have a 
significant disadvantage: they are software tests 
rather than electrical tests. Certainly, since 
memory involves operating software, a software 
test seems to be a logical solution. 

On the other hand, memories are electronic 
devices, run by electricity and influenced in their 
failings by electrical and physical forces. Barring 
removing each memory and running 
sophisticated electrical tests on it, then, there is 
only one serious memory test option: test each 
bit in combination with each and every other bit 
in the device. Unfortunately, that is impractical, 
since there are 393,216 bits in a 48K system, and 
testing every one would result in over 
150,000,000,000 separate tests - a task that 
would take nearly a solid month running at the 
TRS-80's 1.77 MHz clock rate! 

The remaining option, then, is to make 
reasonable electrical tests that exercise the 
neighboring bits in a memory chip, and read and 
write to them about as fast as the TRS-80 is likely 
to do it in real time. The process I have chosen is 
twentyfold: 



10. Change the surrounding bits from zeros to 
ones. 

11. Read the stored value and check its 
accuracy. 

12. Change the surrounding bits from ones to 
zeros. 

13. Read the stored value and check its 
accuracy. 

14. Change the surrounding bits from zeros to 
ones. 

15. Write the value to memory again. 

16. Read the stored value and check its 
accuracy. 

17. Change the surrounding bits from ones to 
zeros. 

18. Write the value to memory again. 

19. Read the stored value and check its 
accuracy. 



1. Write a value to memory. 

2. Read the stored value and check its 
accuracy. 

3. Change the surrounding bits from zeros to 
ones. 

4. Change the surrounding bits from ones to 
zeros. 

5. Read the stored value and check its 
accuracy. 

6. Change the surrounding bits from zeros to 
ones. 

7. Change the surrounding bits from ones to 
zeros. 

8. Write the value to memory again. 

9. Read the stored value and check its 
accuracy. 



20. Increment the value to be written and 
repeat. 



This process is repeated 256 times, writing 
values from 00 to FF, and producing the electrical 
switches noted above. The program then moves 
itself to another area of memory, and checks the 
area in which it was just residing. 

The entire memory test is still very 
time-consuming, since the address under test is 
displayed while the process is continuing. 



In the program presented in Listing 3-(?), the 
test displays the memory location under test; any 
failed memory location is displayed on the 
screen, along with the bits which have failed. The 
test is presented in a 16K version with changes 
for 32K and 48K systems. 
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Cassette I/O 

One of the most maligned aspects of the 
TRS-80 is its cassette loading procedure. 
Interestingly, it is a lengthy and skillfully 
designed piece of coding, a victim of a 
combination of poor hardware (an inexpensive 
cassette recorder), the inclination personal 
computer owners have to purchase the least 
expensive tapes they can find, and the lack of 
foresight on the part of the engineers designing 
the routines. But there's no question that with a 
good tape recorder and reasonable tape, it works 
well. Here's how. 

The routine to read and accept serial 
information is fairly convoluted, collapsed to 
about a dozen major subroutine CALLs. We will 
start with the SYSTEM command; since BASIC 
programs have other bytes to juggle (looking for 
out-of-memory errors, etc.), we won't tackle its 
major routines. 



The SYSTEM module 

The SYSTEM command is evaluated by the 
BASIC interpreter, and its control routine is 
entered at 02B2. If you don't want to know how 
this command gets to work, then skip right to the 
tape loading routine two paragraphs below. An 
initial CALL is executed to DOS link 41E2, which 
in Level II merely executes a RETurn. The stack 
is set up at 4288, and another CALL executed to 
20FE, which checks the DOS link at 41C1, picks 
up the 'device type' - video, tape, or printer - 
(video at this time), displays a carriage return, 
checks and saves port FF status (32 or 64 
character mode and cassette state), clears the 
accumulator, and returns. This is preparatory 
housekeeping. 

The accumulator is set up with a star, it is 
displayed (with more housekeeping), and the 
INPUT routine is CALLed from location 1BB3. 
This is the same routine used for INPUT 
statements, and it displays a question mark, 
evaluates the input line, discards everything 
after certain punctuation, and returns the 
evaluated line to the CALLing program. If a 
BREAK is discovered, the program returns to 
READY. Spaces, line feeds, tabs, etc., are 
cleaned out, and a syntax error is declared if no 
alphanumeric characters are found. If a slash (/) 
is found, the SYSTEM program jumps past its 
loading routines, picks up the start address from 
40DF (more about that later), cleans out blanks 



again, and evaluates the string after the slash as 
an interger (a CALL to 1E5A). The whole 
business starts over if a non-numeric string is 
found. If, at last, the program does discover that 
a number was input, the SYSTEM module is 
executed from the starting address stored at 
40DF. 



Build-a-Byte 

The first major loading call is to 0293, which 
searches for a synchronization byte. Since this 
will eventually call the 'build-a-byte' routine, 
let's move there first. It begins at 0241; BC and 
AF registers are saved. Then: 



0243 


DB FF 


IN 


A, IFF] 


0246 


17 


RLA 




0246 


30 FB 


JR 


NC.0243 


0248 


06 41 


LB 


B,41 


024A 


10 FE 


DJNZ 


024A 



Port FF is checked repeatedly by inputting the 
value to the accumulator and rotating that value 
into the carry flag. If no carry is found - i.e., no 
'one' bit has yet triggered port FF - the program 
loops back to 0243. Once a bit is found, the B 
register is loading with 41, and a 'waste time' loop 
is executed at 024A (a total of just under 500 
microseconds). A CALL is then executed to 
02 IE. Let's have a look at that: 



081 E 


21 00 FF 


LD 


HL.FF00 


0221 


3A 30 40 


LD 


A,(403D) 


0224 


M 


AND 


H 


0225 


B6 


0B 


L 


0226 


03 FF 


OUT 


IFF) ,A 


0228 


32 3D 40 


LD 


(4030], A 


022B 


a 


RET 





This curious subroutine seems to stumble 
through checking port FF for its video state, then 
resetting the OUTSIG flip-flop (see the 
Technical Reference Handbook for details on 
this circuitry). Isn't a byte ANDed with FF and 
ORed with 00 merely itself? True enough, but 
since this is also called as a subroutine entering at 
0221, with a different value for HL, the complex 

AND/OR strategy makes sense. 

So at this point we have picked up a bit from 
tape, delayed, and reset the flip-flop, readying it 
for the next bit to trigger it. Another delay loop 
follows (over 850 microseconds), and a byte is 
input to A from port FF: 



0253 


DB FF 


IN 


A, IFF) 


0255 


47 


LD 


B,A 


0256 


F1 


POP 


AF 


0257 


CB 10 


RL 


B 


0259 


17 


FLA 




025A 


F5 


PUSH 


AF 
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The input byte is saved in the B register, and 
the previously saved value of A is restored from 
the stack. Here is a wonderful piece of 
serial-to-parallel conversion - a sort of software 
shift register. Bit 7 of port FF was input to A and 
saved in B, and is then rotated left into the carry 
flag. Then the accumulator is rotated left, 
bringing the state of the carry flag into bit of A. 
The accumulator is then saved once more on the 
stack. Another CALL to 021E resets the port FF 
flip-flop, both registers are restored, and the 
subroutine returns to the calling program. 

You'll notice that at this point we have only 
one bit saved in the accumulator. An 
eight-iteration loop would be necessary to create 
a whole byte . . . and it will be done. But for the 
moment let's see how this routine is used in the 
initial syncing program, which we were about to 
enter at 0293. 

The routine's first action is to CALL 01FE. 
This is a detailed routine to determine the drive 
number and other parts of the syntax, the state of 
port FF (again), select the drive and get it 
moving. Examining the code will show that it 
also uses the routine entered at 0221, but with a 
value of FF04 in HL; this routine won't be 
covered here, but it is worth looking at. 

The find-sync-byte routine thus turns on the 
tape, saves the HL register, clears the 
accumulator, and calls the 'build-a-byte' routine 
at 0241. Since this is the synchronization process, 
no loop value is specified: 



0297 


AF 


X0R 


A 


0298 


CD 41 02 


CALL 


0241 


029B 


FE A5 


CP 


AS 


0290 


20 F9 


JR 


NZ.0298 



It continually seeks bits, endlessly rotating the 
accumulator until it assembles a serial stream 
which matches A5 (i.e., binary 10100101 - nice 
and symmetrical). This routine is so accurate, in 
fact, that whenever tape motor start-up is not a 
consideration, the leader consisting of zero bytes 
would be unnecessary. The leading '1' of A5 
serves as a kind of serial 'start bit' - and the 
routine at 0241 handles it from there. 

Any kind of match to sync byte A5 might be 
found, tough, since the serial stream coming in 
from the tape does not distinguish start and end 
of byte. For example, the byte pattern DD 28 
also contains an A5 embedded in it. As a serial 
stream, DD 28 is 

1101110100101000 
10100101. . . . 



- with the A5 appearing at the junction of DD 
and 28. So once the matching A5 is found, a 
return is executed to the main SYSTEM loading 
module. That module then CALLs a subroutine 
at 0235, which is a gussied-up bit reader. BC and 
HL are saved, then: 



0237 


06 0B 


LD 


B,08 


0239 


CD 41 02 


CALL 


0241 


023C 


10 FB 


DJNZ 


0239 



There's the byte read . . . read a bit with eight 
iterations. HL and BC registers are restored, and 
the subroutine returns to the main program. 



Loading the Code 

The SYSTEM module now compares the byte 
it created with the value 55, the code assigned to 
machine language programs. It loops until it 
finds that code, then proceeds: 



02D8 


06 06 


LD 


B,6 


020A 


7E 


LD 


A,(HL) 


02DB 


B7 


OR 


A 


02DC 


28 09 


JR 


Z.02E6 


02DE 


CD 35 02 


CALL 


0235 


02E1 


BE 


CP 


IHL) 


02E2 


20 ED 


JR 


NZ.02C1 



Above, the B register is loaded with the 
number of characters to be found in the 
SYSTEM program's name. The accumulator is 
set up with the first character of the name as 
entered on the *? command line. The 
accumulator is tested for zero, and skips out of 
the loop when the end of the entered name is 
found. Each character following the name is read 
into the accumulator (CALL 0235) and compared 
with each letter of the entered name. If at any 
point the entered name does not match the name 
on tape, the program goes back to searching for 
55 (machine program indicator) and the name 
search begins again. 

There is a minor flaw in this process. Let's look 
at the succeeding lines of code: 



02E4 
02E5 



23 
10 F3 



INC 

DJNZ 



HL 
02DA 



This coding increments the HL register to the 
next character and loops back, looking for a total 
of six letters in the name. But what if the 
machine program code (55) is found, and one or 
more characters of the name match, but the rest 
do not match? There is no provision in this 
routine to decrement the HL register pair . . . 
which means that, if only part of a correct name 
has been found.the program will begin its search 
anew until it finds a program that matches only 
the last part of the entered name! This is the 
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reason the SYSTEM routine is not always able to 
search until it finds the correct program, the way 
the BASIC load does. 

Let's assume the best - that a machine 
program was found with the name as entered 
from the keyboard. A CALL is then made to 
022C, where the star or space at 3C3F is toggled 
(XORed) with OA. Star XOR OA is a space, and 
space XOR OA is a star; easily done. 



The SYSTEM Module Continues — 



02EA 


CD 35 


02 


CALL 


0235 


02ED 


FE 78 




CP 


78 


02EF 


26 B8 




JH 


Z,02A9 


02F1 


FE 3C 




CP 


3C 


02F3 


20 FS 




JR 


NZ.02EA 



- searching for either 78 (end of program code) or 
3C (beginning of data block code). If 78 is found, 
the program skips back to 02A9, where a CALL is 
executed to 0314. This subroutine merely reads 
the last two bytes on tape into the HL register, 
preparing the start address. This is saved at 
40DF, the cassette recorder is turned off (CALL 
01F8), and the SYSTEM module is re-entered 
from the start at 02B2. This module is a 
continuous loop, allowing a group of 
machine-language programs to be entered 
sequentially. Only the presence of the slash-start 
address combination will break out of the loop. 



If a 3C is found, the beginning of a block of 
machine code is assumed. (If neither is found, 
the program loops until it finds one or the other). 
Here's a snippet of code: 



Curious Checksum 

Each succeeding byte is read from tape and 
placed at the address now specified by HL. That 
byte is also added to the C register to update the 
simple checksum. HL is incremented to the next 
contiguous address, and the loop is iterated until 
B (the number of bytes to read in the block) 
reaches zero. 

When the block is fully read, another byte is 
read from tape. This is the checksum byte, and 
should match the last updated value in the C 
register. If it does match, the program loops 
back, toggles the star, and begins anew the search 
for end-of-program (78) or block header (3C). 

A correct checksum byte, curiously enough, is 
not a necessary element of the SYSTEM module. 
If the checksum is incorrect, the program will 
display a 'C at video location 3C3E, and loop 
back regardless to continue reading the program 
from tape. I first noticed this action when a 
gentleman from New Hampshire called; he had 
been using a tape duplication routine to make a 
corrected copy of a machine language program. 
He had loaded the tape, returned to BASIC, then 
POKEd in a few byte changes. He then 
continued with the duplication. When he loaded 
the tape later on, he got a 'C error message on the 
screen . . . but the program continued to load and 
did execute properly. The checksum was wrong 
because of the byte changes he had made, but the 
program, checksum notwithstanding, was read 
and loaded completely. 

Let's take a look at that final portion of code: 



02F5 


CD 35 02 


CALL 


0235 


02F8 


47 


LD 


B,A 


02F9 


CD 14 03 


CALL 


0314 


02FC 


85 


ADD 


A,L 


02F0 


4F 


LD 


C,A 



02FE 


CD 35 


02 


CALL 


0235 


0301 


77 




LD 


(HL),A 


0302 


23 




INC 


HL 


0303 


81 




ADD 


A,C 


0304 


4F 




LD 


C,A 


0305 


10 F7 




DJNZ 


02FE 


0307 


CD 35 


02 


CALL 


0235 


03 0A 


89 




CP 


C 


030B 


28 DA 




JH 


Z.02E7 


0300 


3E 43 




LD 


A, 43 


03 OF 


32 3E 


3C 


LD 


(3C3E) 


0312 


18 06 




JR 


02EA 



A byte is read and saved in B. At 0314, two 
bytes are read and saved, respectively, in the HL 
register pair. These three bytes are, first, the 
number of bytes to read, and second, the 
two-byte starting address of the block. The 0314 
subroutine leaves the value transferred to H in 
the accumulator; to it is added the value in L, and 
this number, sans carry value, is saved in the C 
register. The C register will be used to calculate 
the checksum for the block being read. 



Overall, these routines give the appearance of 
being reasonable and reliable, and they should 
be. What, then, gives rise to the tape problems? 
Mostly the timing loop in the 0235/0241 
subroutine. The values placed in the B register at 
0248 and 024F are too short for low-grade audio 
processing. Simply stated, the audio waveform 
coming in from tape 'rises' too slowly for the fast 
bit-check loop at 0251 to catch. A 'one' might 
come through, but it comes through too laggardly 
for port FF to have flipped into place. 
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00100 ; 


iimiiiiiiimiiiiiiiHiiiimiitiiinnimiintittii 




00110 ; 


VOICE 


INPUT/OUTPUT ROUTINE 


USING THE CASSETTE PORT AND 




00120 ; 


AMPLIFICATION. CAN BE USEC 


l WITH CTR TAPE RECORDERS AND 




00130 ; 


BUILT 


-IN MICROPHONES OR PREFERABLY EXTERNAL CRYSTAL 




00140 ; 


HICS. 


SMALL 


SPEAKER OUTPUT 


INCREASES INTELLIGIBILITY. 




00150 ; 


innmminiiiHtiummiiiiimimiiiiittimiii 




00160 ; 










4300 


00170 




UHG 


4300H 


; LOW POINT IN MEMORY 




001 BO ; 




ORG 


6500H 


; USE WITH DISK BASIC 


06 CC 


00190 MONITR 


EOJJ 


06CCH 


; BASIC EXIT 10R OTHER) 


4300 F3 


00200 START 


DI 




; NO BOTHERSOME STUFF 


4301 CDC901 


00210 




CALL 


01C9H 


; CLEAR THE SCREEN 


4304 3A3040 


00220 




LD 


A,(403DH) 


; START BY RESETTING PORT 


4307 D3FF 


00230 
00240 ; 




OUT 


10FFH),A 


; TO CLEAR INCOMING BITS 




00250 ; 


illiiniiiniliiiiliiiitlllili 




00260 ; 


KEYBOARD ROUTINE FOR ENTER 


[INPUT), CLEAR [OUTPUT), OR 




00270 ; 


UP-ARROW (BASIC). UP-ARROW GOES TO EXIT IF NOT BASIC. 




002B0 ; 


lllllinilllllllllllllllllllllllllllllllllllltltlllllll 




00290 ; 










4309 3A4038 


00300 KEYTST 


LO 


A,(3840H) 


i GET ENTER/CLEAR ROW 


430C FE01 


00310 




CP 


1 


J CHECK IF ENTER PRESSED 


430E 2S0B 


00320 




JR 


Z, INPUT 


j GO TO INPUT ROUTINE 


4310 FE02 


00330 




CP 


2 


; CHECK IF CLEAR PRESSED 


4312 2850 


00340 




JR 


Z, OUTPUT 


; GO TO OUTPUT ROUTINE 


4314 FE08 


00350 




CP 


B 


; CHECK FOR UP-ARROW 


4316 CACC06 


00360 




JP 


Z, MONITR 


; OUT TO BASIC OR MONITOR 


4319 18EE 


00370 
00380 | 




JR 


KEYTST 


; BACK FOR A VALID KEY 




00390 


; llllllli 




00400 ; 


INPUT 


FROM PORT FF 1255 DECIMAL) ANO STORAGE IN MEMORY 




00410 ; 


tllltlltllltlllttlttilllimitllllltlllltlltttlttllllll 




00420 | 










431 B 21A343 


00430 ; 


[NPUT 


LD 


HL.MSG01 


i GET THE "INPUT" MESSAGE 


431 E CDA728 


00440 




CALL 


28A7H 


; AND DISPLAY ON SCREEN 


4321 3A3D40 


00450 




LO 


A.1403DH) 


; GET VALUE FOH PORT MASK 


4324 4F 


00460 




LD 


C,A 


; SAVE MASK IN C REGISTER 


43 25 210044 


00470 




LD 


HL.4400H 


; BEGIN VOICE STORAGE 




00480 




LD 


HL,6700H 


; BEGIN STORAGE [DISK) 


4326 1608 


00490 I 


-00P1A 


LD 


0,8 


; NUMBER OF BITS IN BYTE 


432A DBFF 


00500 I 


-0OP2 


IN 


A.IOFFH) 


; GET VALUE AT THE PORT 


432C CB17 


00510 




RL 


A 


; STASH IT IN CARRY BIT 


43 2E CB13 


00520 




HL 


E 


; BUMP IT INTO E REGISTER 


4330 79 


00530 




LD 


A,C 


; GET VALUE OF PORT MASK 


4331 3A4038 


00540 




LD 


A,(3840H) 


; CHECK ENTER/CLEAR ROW 


4334 FE80 


DO 550 




CP 


80H 


; CHECK IF SPACE PRESSED 


4336 C25343 


00560 
00570 




JP 


NZ, ESCAPE 


; OUT IF KEYBOARD CLEAR 




00580 


; llll 


NOTE: 


DELAY VALUE USED IN THE B REGISTER IS llll 




00590 


i nit 


CHOSEN 


FOR OPTIMUM INTELLIGIBILITY. WITH THE llll 




00600 


; llll 


CTR TAPE RECORDER AND 


HARDWARE MODIFICATION, llll 




00610 


; III! 


A LONGER VALUE CAN BE 


USED IF HIGH-FIDELITY llll 




00620 


i HII 


INPUT IS PROVIDED. FOR EACH INCREASE IN THE llll 




00630 


; III! 


B-REGISTER DELAY VALUE, ALSO INCREASE THE B- llll 




00640 


; HII 


REGISTER BY THE SAME 


AMOUNT FOR PLAYBACK. llll 




00650 


; III! 


LIKEWISE, A DECREASE 


IN THE DELAY VALUE MAY llll 




00660 


; llll 


INCREASE FIDELITY AT 


A SACRIFICE OF MEMORY, llll 




00670 


• 








4339 0604 


006 BO 




LO 


B,4 


; GET SHORT DELAY VALUE 


433B 10FE 


00690 


0ELAY1 


OJNZ 


DELAY1 


; AND DELAY A WHILE 


433D D3FF 


00700 




OUT 


lOFFHJ.A 


; MUST RESET PORT INPUT 


433F 15 


00710 




DEC 


D 


; DECREMENT TOTAL BITS 


4340 C22A43 


00720 




JP 


NZ.L00P2 


; CONTINUE IF MORE TO DO 


4343 73 


00730 




LD 


(HL),E 


J SAVE FULL BYTE IN MEM. 


4344 23 


00740 




INC 


HL 


; GO ON TO NEXT BYTE 


4345 7C 


00750 




LD 


A,H 


; GET VALUE OF M.S. BYTE 


4346 FEO0 


00760 




CP 


OOH 


; USE FOR 48K MACHINE 




00770 


; 


CP 


OCOH 


; USE FOR 32K MACHINE 




0078O 


; 


CP 


080H 


; USE FOR 1EK MACHINE 


4348 C22843 


00790 




JP 


NZ.L00P1A 


; IF NOT DONE THEN MORE 


4348 21C743 


DOBOQ 




LD 


HL.MSG02 


; GET "INPUT COMPLETE" 


434E C0A728 


00810 




CALL 


28A7H 


; AND DISPLAY THE MESSAGE 


4351 18B6 


00820 
00830 




JR 


KEYTST 


; DONE - BACK TO KEY TEST 




00840 


■ imiiiiiinn 




00850 


; PAUSE CHECK 


DURING ENTRY; 


SPACEBAR = GO, OTHERWISE STOP 




00860 


; llllllllllllllllllllllllllllllllllinilllllllllllllllll 




00870 


J 








4353 E5 


00880 


ESCAPE 


PUSH 


HL 


; SAVE CURRENT POINTER 


4354 CDAFOF 


00690 




CALL 


OFAFH 


; DISPLAY CURRENT MEM. 


4357 213944 


00900 




LO 


HL.HSG05 


; GET "WORD START" MESS. 


435A CDA728 


00910 




CALL 


28A7H 


; AND DISPLAY THE MESSAGE 


43 5D E1 


00920 




POP 


HL 


J RESTORE MEMORY PTR. 


43 5E 3A403B 


00930 


RECHEK 


LD 


A, I 3 840 H) 


; ENTER/CLEAH KEYBRD ROW 


4361 FEBO 


00940 




CP 


BOH 


; CHECK IF SPACE AGAIN 


4363 2BC3 


00950 




JR 


Z.L0OP1A 


; BACK TO MAIN LOOP 


4365 FE04 


00960 




CP 


4 


; CHECK IF BREAK KEY 


4367 20F5 


00970 




JR 


NZ, RECHEK 


; KEEP LOOKING ENT OR BRK 


4369 21C743 


00980 




LD 


HL.MSG02 


; GET "INPUT COMPLETE" 


436C CDA728 


00980 




CALL 


26A7H 


; AND DISPLAY THE MESSAGE 


436F 189B 


01000 
01010 




JR 


KEYTST 


; AND BACK TO KEY MENU 



Special Loaders 

This was initially one of the mysteries of 
TRS-80 operations. Microchess was produced 
with a loader, then others quickly followed, 
mysteriously taking control of the machine and 
locking it up completely. 

Let's now take a look at some of these special 
loaders, which will be designated Loaders A, B, 
C, and D in order to help them continue to do the 
job they were supposed to - protect software. 

Loader A sets up a stack at 5000, clears the 
accumulator, and calls ROM to turn on the tape 
recorder and find the sync byte. It places a star 
on the bottom of the screen, sets up the HL 
register to receive the program, and prepares 
register C to perform simple checksum. A byte is 
read, it is saved in memory, and the checksum is 
created as in the SYSTEM mode. Then: 



4025 


7C 






LD 


A,H 


4D26 


1F 






RRA 




4027 


23 






INC 


HL 


4D28 


3E 


2A 




LD 


A,2A 


4D2A 


DA 


2F 


4D 


JP 


C.402F 


4020 


3E 


20 




LD 


A, 20 


40 2F 


32 


FD 


3F 


LD 


[3FFD),A 


4D32 


3E 


4C 




LD 


A,4C 


4034 


BC 






CP 


H 


4D35 


C2 


1F 


4D 


JP 


NZ.4D1F 


4038 


3E 


FF 




LD 


A.FF 


403A 


au 






CP 


L 


4D3B 


C2 


1F 


4D 


JP 


NZ.401F 


4D3E 


B9 






CP 


C 


4D3F 


C2 


00 


DO 


JP 


NZ.0000 


4042 


CD 


F8 


01 


CALL 


01 FB 


4D45 


C3 


BO 


47 


JP 


4780 



The strange appearance of RRA has nothing to 
do with rotating incoming bits. Rather, since the 
accumulator contains the H register value, each 
page (256 bytes) of information will change the 
high page value by one. Consequently, the high 
page will alternate between odd and even values, 
and the least significant bit, rotated into the 
carry flag, will trigger the display-star or 
display-space routines at 4D2F. 

Finally, this somewhat awkward loader does a 
pair of compares to see if it has yet reached 4CFF, 
the end of the program load. If not, it loops back 
and continues; if so, it examines the checksum in 
C. Amazingly enough, it goes back to MEMORY 
SIZE? if there is a checksum error! There's no 
tampering with this program. A successful load 
is followed by a jump to the program's beginning 
at 4780. 

Loader B is virtually identical to Loader A, 
except that the beginning of the program is found 
at 41FD instead of 4780. 

Loader C is of a more interesting variety. It is 
written entirely without calls to ROM, because it 
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Continued Listing 



01080 ; #♦#»#»♦#♦#♦##♦»*#♦#######»»♦♦#»»########»#♦##*♦«#*#### 

01030 ; OUTPUT FROM MEMORY OF RECORDED VOICE TO CASSETTE PORT 

01040 ; tHtltimmHilimlttlltlllltti)tttlllllliltHtlfttt 

01050 ; 



4371 21E743 


01060 


OUTPUT 


LD 


HL.MSG03 ; 


GET "BEGIN OUTPUT" 


4374 CDA728 


01070 




CALL 


28A7H 


AND DISPLAY THE MESSAGE 


4377 3A3D40 


01080 




LD 


A.I403DH) i 


PORT FF OUTPUT MASK 


437A 4F 


01090 




LD 


C,A 


SAVE OUTPUT MASK IN C 


437B 210044 


01100 




LD 


HL,4400H 


START VOICE STORAGE (•) 


437E 1608 


01110 


L0OP3A 


LD 


0,8 , 


NUMBER OF BITS IN BYTE 


4380 7E 


01120 




LD 


A,(HL) 


GET VALUE FROM MEMORY 


43B1 5F 


01130 




LD 


E,A 


SAVE IT IN E REGISTER 


438? AF 


01140 




XOR 


A 


CLEAR ACCUMULATOR TO 


4383 CB13 


01150 


L00P4 


PL 


E 


SEND BIT TO CARRY FLAG 


4385 CB17 


01160 




HL 


A 


AND ROTATE 'ROUND TO A 


4387 B1 


01170 




OH 


C 


USE THE PORT FF MASK 


43BB D3FF 


01180 




CUT 


(OFFHJ.A 


ANO SEND OUT THE VALUE 




01190 


; 








01200 


; Hit 


NOTE: PLA1 




01210 


; nti 


TO MATCH 


SAMPLING DELAY IN THE INPUT SECTION llll 




01220 


; llll 


OF THIS 


I/O PROGRAM. THIS VALUE IS ROUGHLY llll 




01230 


; llll 


TWO TIMES THAT IN THE B-REGISTER DURING THE llll 




01240 


; till 


INPUT SAMPLING. VARIOUS DUMMY OPCODES HAY llll 




01250 


; till 


BE INSERTED WHERE NECESSARY TO KEEP VOICE III! 




01260 


; III! 


AT THE PROPER PITCH AND QUALITY. USING THIS llll 




01270 


; llll 


PROGRAM 


THERE IS A QUARTER-TONE DIFFERENCE, llll 




01280 


; 






438A 0606 


01290 




LD 


B,6 


GET SHORT DELAY VALUE 


43BC 10FE 


01300 


DELAY 


DJNZ 


DELAY 


AND DELAY SHORT WHILE 


438E AF 


01310 




XOR 


A 


CLEAR ACCUM. BACK TO 


43BF 15 


01320 




DEC 


D 


BITS ■ BITS MINUS ONE 


4390 C28343 


01330 




JP 


NZ.L00P4 


AND BACK FOR SOME MORE 


4393 23 


01340 




INC 


HL 


GET NEXT BYTE FROM MEM. 


4394 7C 


01350 




LD 


A,H 


GET VALUE OF M.S. BYTE 


439S FEOO 


01360 




c;p 


OOH 


FOR 48K MACHINE 




01370 


j 


CP 


OCOH 


; FOR 32K MACHINE 




01380 


; 


UP 


OBOH 


; FOR 16K MACHINE 


4397 C27E43 


01390 




jp 


NZ.L00P3A 


; AND GO BACK FOR MORE 


439A 210E44 


01400 




LD 


HL.MSG04 


, GET "OUTPUT COMPLETE" 


4390 C0A72B 


01410 




CALL 


2BA7H 


; ANO DISPLAY THE MESSAGE 


43A0 C30S43 


01420 




JP 


KEYTST 


; AND BACK WHEN DONE 




01430 


; 






43A3 48 


01440 


MS601 


DEFM 


'HOLD SPACE BAR AND BEGIN SPEAKING.' 


43 C5 00 


01450 




DEFB 


DDK 


43C6 00 


01460 




OEFB 


OOH 


43C7 49 


01470 


MSG02 


DEFM 


'INPUT COMPLETE OR MEMORY FULL. 1 


43 E5 00 


01 480 




DEFB 


OOH 


43 E6 00 


01490 




DEFB 


OOH 


43 E7 42 


01500 


MSG03 


DEFM 


'BEGINNING PLAYBACK; BREAK IS IGNORED. 1 


440C 00 


01510 




DEFB 


OOH 


440D 00 


01520 




OEFB 


OOH 


440E 50 


01530 


MSG04 


DEFM 


'PLAYBACK COMPLETE; PRESS CLEAR TO REPEAT. 


4437 00 


01540 




DEFB 


ODH 


443B 00 


01550 




OEFB 


OOH 


4439 20 


01560 


MSG05 


DEFM 


' = WORD SEPARATION POINT . ' 


4452 00 


01570 




DEFB 


OOH 


4453 00 


01580 
01590 




DEFB 


OOH 




01600 


; lllllll 


4300 


01610 




END 


START 


00000 TOTAL 


ERRORS 








291 21 TEXT 


AREA BYTES LEFT 




DELAY 43 8C 


D1300 


01300 






DELAY1 433B 


00690 


00690 






ESCAPE 4353 


00880 


00560 






INPUT 431 B 


00430 


OD320 






KEYTST 4308 


00300 


00370 


00820 01000 01480 


L00P1A 4328 


00490 


007 90 


00950 




L00P2 432A 


00500 


00720 






L00P3A 437E 


01110 


01390 






LOOP 4 4383 


01150 


01330 






MONITR 06CC 


00190 


00360 






MSG01 43A3 


01440 


00430 






MS602 43C7 


01470 


00800 


00980 




MS603 43 E7 


01500 


01060 






MSG04 440E 


01530 


01400 






MSG05 4439 


01560 


00900 






OUTPUT 4371 


01060 


00340 






RECHEK 435E 


00930 


00S70 






STAHT 4300 


00200 


01610 









is capable of loading into a Level I or Level II 
TRS-80. Less fortunately, the ROM timing 
errors are not corrected, so the chances of loading 
this program on a marginal machine are not at all 
improved. The stack is prepared, and a block of 
memory is cleared from 5800 to the end of 
potential RAM at FFFF. My only guess as to the 
reason for this is that the authors wish to wipe 
out any programs such as monitors or 
disassemblers, as the clearing byte (A5) does not 
strike me as otherwise meaningful. 

The tape is then turned on, and a pattern of 
three asymmetrical and two symmetrical sync 
bytes is found (Bl, 83, 79, 5A, 00). Again, the 
choice strikes me as arbitrary, and may be the 
authors' way of identifying their own code. If 
these bytes are found, the program continues; if 
not, the entire five-byte pattern is sought again. 

As in the other loaders, register C is set to zero 
for use as a checksum byte. The program load 
point is set high in memory (747F), and a byte is 
read. Here is a part of the code: 



4330 


CD 


BF 


43 


CALL 


43 8F 


4340 


77 






LD 


IHL) ,A 


4341 


32 


3F 


3C 


LD 


I3C3F) ,A 


4344 


B1 






ADD 


A,C 


4345 


4F 






LD 


C,A 


4346 


2B 






DEC 


HL 


4347 


7D 






LD 


A,L 


4348 


3C 






INC 


A 


4349 


C2 


S3 


43 


JP 


NZ.4353 


43 4C 


CD 


8F 


43 


CALL 


43 8F 


43 4F 


B9 






CP 


C 


4350 


C2 


66 


43 


JP 


NZ.436B 



The secret to this portion of code rests in 
address 4346. Unlike most other loaders, this one 
loads (and displays) the last byte of code first, 
moving backwards through memory. (438F is the 
location of the byte-read subroutine). When the 
page is crossed (4346-4348), the checksum is 
evaluated; if the checksum is incorrect the 
program jumps to 4366, where an error message is 
displayed and the machine locks up. 

The user's display is worth noting: 



4353 
4354 



7C 

32 3E 3C 



LD 
LD 



A,H 

(3C3E),A 



This loader actually displays the ASCII 
equivalent of the page of memory being loaded 
with data . . . and it looks like an alphanumeric 
countdown as the program is fit into place. 

Finally, Loader C does a comparison for the 
end of the first major load block, changes the 
value of H, and loads the next block. It then 
overwrites critical portions of the load routine, 
effectively obscuring the loading and entry point 
of the program. Interrupts are disabled, and the 
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process moves out of the loader into the main 
program. Interestingly, the authors forgot to 
turn the tape recorder off. 

Finally, Loader D is of an entirely different 
sort. First, some code: 



BEFE 


3E 


04 


LD 


A, 4 


BFOD 


D3 


FF 


OUT 


IFF), A 


BF02 


DB 


FF 


IN 


A, IFF) 


BF04 


17 




RLA 




BFDS 


30 


FB 


JR 


NC.BF02 


BF07 


06 


XX 


LD 


B,XX 


BFOS 


10 


FE 


DJNZ 


BF09 


BFQB 


06 


09 


LD 


B,9 


BFOD 


3E 


04 


LD 


A, 4 


BFOF 


D3 


FF 


OUT 


IFF), A 


BF11 


DB 


FF 


IN 


A, IFF) 


BF13 


17 




HLA 




BF14 


00 




NOP 




BF15 


38 


OC 


JR 


C.BF23 


BF17 


23 




INC 


HL 


BF1B 


2B 




DEC 


HL 


BF18 


10 


F6 


DJNZ 


BF11 



This remarkable loader is written for 
high-speed operation, setting up the output ports 

BEFE and BFOD), clocking itself with start bits 
(BFOD), and then reading a nine-bit serial 
stream. Careful timing and self-clocking are 
essential in high-speed data I/O, and this routine 
is capable of reading and writing on ordinary 
audio cassettes, with excellent reliability, at 
better than 2000 baud. The only point to the 
instructions at BF17 and BF18, for example, is 
the delay introduced by executing them; yet that 
timing is very important. The actual timing 
value at BF07 has been dropped for a measure of 
protection of this author's fine software. 

Conclusions 

In sum, the tape read/write routines of the 
TRS-80 are efficient and, especially now with 
special loaders and a corrected ROM, quite 
reliable. Different levels of user prompts, 
particularly those used by the reverse-loading 
module described above, are probably more 
satisfactory than flashing stars. A checksum 
process for BASIC similar to the SYSTEM 
module would have been valuable. Finally, by 
careful attention to clocking details, a reliable, 
higher speed loader could have been included in 
the TRS-80. 

For those especially interested in high-speed 
loaders, I recommend examining the Exatron 
Stringy- Floppy operating system, which shows 
what can be done with equipment designed for 
digital operation. It is capable of reliable loading 
and saving at rates exceeding 11,000 baud. 
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Fig. 2. Full schematic tor the Model I cassette modification tor speech input. It should 
be switched out when cassette programs are being loaded (see Fig. 4). 
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Simple Modifications 

Why hardware modifications? Simply 
because they help a limited computer broaden 
its ability to serve our needs. Looking at glowing 
blue-white letters on a dark screen is 
comfortable for only a limited time . . . waiting 
through many minutes for the computer to make 
a game play is frustrating . . . attempting to 
imagine which characters are upper case and 
which are lower case is nearly impossible . . . 
emphasizing individual words and characters is 
only possible with arrows and stars . . . and so 
forth. 

In this chapter, eleven simple modifications to 
the standard TRS-80 will be presented: 

Installing 16K memory to the keyboard unit, 
and to the expansion interface. 

A change to enable recovering Resets when 
there is an expansion interface attached. 

Moving the Reset button to a more accessible 

position. 

Adding both an extra keyboard and an extra 

video output for extending the computer's 

portability. 

Adding an RF modulator to further increase 
the TRS-80's portability. 

Installing a modification to increase the 
computer's computational speed. 

Installing a modification to reverse the video 
display for black letters on a white 
background, more in keeping with real text. 



Adding the feature of dual-language 
operation: Level I and Level II in the same 
computer. 

Accessing the lower case capabilities built 
into the TRS-80 by adding a single circuit. 

Reversing individual characters on the 
screen for emphasis. 

Adding a hexadecimal keypad for faster 
entry of machine code information. 

Almost all of these modifications will require 
you to open the cabinet of your TRS-80. Should 
you do it? Or should you not? First of all, 
consider that your computer has but a three 
month warranty; after that, you will have to pay 
repair charges should something go wrong. 
Radio Shack has, in response to public protests, 
changed its former policy and will now repair 
machines with the most popular modifications 
installed, at no extra charge. They will not 
remove those modifications if you say so, but 
may refuse repair if (a) you have mangled the 
board, or (b) if you cannot document your 
modifications. 

Yes, there is a chance that you can damage 
your TRS-80 when you make modifications. 
This will not be the fault of the modifications 
themselves, though. My own TRS-80 has been 
modified many times, and the only damage has 
been to the notoriously flakey cable that 
connects the keyboard to the main circuit card, 
and the failure of one RAM chip. The latter 
would have happened anyway. 
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How many TRS-80's have been damaged 
during modification? That's a hard question to 
answer, but I will describe briefly the failed 80's 
I have seen: 

1. A damaged integrated circuit in the data 
section was caused when heavy wire was used 
to make the modification. 

Lesson — use the parts specified. 

2. Two RAM chips were blown when the user 
dropped a soldering iron into the unit when he 
was modifying it. 

Lesson — always turn the power off when 
making the physical changes. 

3. A blown power supply regulator. The user 
had left the unit under an open window. 
Lesson — close the windows in case of rain! 

4. High levels of garbage causing keyboard 
lockout and blown programs. The computers 
were being used next to heavy electrical 
equipment. 

Lesson — treat the computer as if it were a 
very sensitive piece of electronic equipment. 
It is. 

5. Constant keyboard lockout or odd 
characters. The TRS-80 cable had been 

flexed too many times, causing breaks. These 
breaks had destabilized the keyboard circuits, 
causing two ICs to blow. 
Lesson — handle the keyboard cable, that 
most delicate of hardware, with utmost care. 



6. Constant lost memory and programs. The 
RAM chips were not being 'refreshed' because 
the refresh multiplex line was not working. 
The user had plugged in a peripheral device 
upside down, with the power on to both. 
Lesson — make all interconnections with the 
power off. 

In sum, all the above damage was caused by 
carelessness, haste, or attempting to use 
inappropriate materials to do the job. The 

solutions? Resolve not to do all the work in one 
evening. Turn back to the introduction to make 
sure you have the right tools. Work slowly and 
take breaks often. Buy parts from reliable 
suppliers. Read and understand the instructions 
and the theory before you start. 

And finally, if you have any serious doubts 
about the accuracy of the printed information, 
contact the author. That's me. And if you have 
any problems that won't go away, write. If you 
write, you must enclose a self-addressed, 
stamped envelope, a complete description of any 
problem, and all tests you have made. Also, I 
cannot cover much beyond the scope of this book, 
which includes the myriad competing disk 
operating systems and support software. 

Expanding the Memory 

The simplest modification, once you have 
braved opening the cabinet, is expanding the 
unit's memory from the 4K supplied to a full 
16K RAM. At this writing, 16K of reliable RAM 
memory can be purchased for less than $20. 



Keep It Clean! 

If you examine the contacts on the keyboard 
unit's edge-card connector, as well as on the five 
connectors (expansion in, expansion out, 
printer, RS-232, disk) of the Expansion 
Interface, you will see a major cause of the TRS- 
80's instability: solder-plated connectors. In the 
interest of economy, Radio Shack did not use 
gold to ensure a good cable contact. This turned 
out to be a serious error in judgment. 

There are two options in dealing with these 
solder-plated connectors. The first is to keep 
them clean. Remove the cables regularly and 
vigorously rub the contact surfaces with a 
dollar bill or talc buffing wheel. Bring the 



solder to a bright shine, and spray it with 
contact cleaner. Reinstall the cables and 
memory crashes should lessen. 

The other option is expensive and 
time-consuming, but much more reliable. The 
contacts can be freed of solder plating with 
solder wick, cleaned with flux remover, brushed 
to a high shine, and a soft silver compound can 
be flowed onto the edge contacts. Fuller 
Software (see Appendix I) sells a contact 
plating kit; price varies with the price of silver, 
but at this writing it is more than $20. The 
process is very tedious because silver melts at a 
much higher temperature than lead, but the 
results are noise-free connections and greater 
reliability. 
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There are several types of so-called '16K 
memories', so when you set out to upgrade your 
TRS-80 memory, make sure you order the 
correct type. 16K is actually a shorthand term 
for 16,384 bytes of memory. In the TRS-80, the 
16K memories are integrated circuits containing 
16,384 single-bit memory cells each. To create 
an entire byte, then, eight integrated circuits are 
needed. Furthermore, the TRS-80 memory 
needs very little power, and must take only a 
small amount of space in its cabinet. The only 
small, low-power memories made are 'dynamic' 
memories. The 16K-by-one-bit, dynamic 
memory is industry type 4116, also called type 
416. 

There is one other consideration in purchasing 
memory expansion chips, and that is a popularly 
misunderstood quality called access time. 
Access time can be thought of as the time it 
takes the computer to inform the memory chip 
that it needs information (or will give it 
information) until the memory chip is 
electronically ready to respond. This figure is 
usually given in nanoseconds (see Table 4-1). 

Second 1 

HUH second (mSJ 0.G01 

Microsecond US) 0.000001 

Nanosecond (nS) 0.000000001 

Table 4-1. Relative time units. 

This time is very small but quite critical to the 
operation of the computer. If the memory is not 
ready, programs and data will be recorded or 
reported incorrectly, and the computer will have 
no chance of working properly. The minimum 
access time for memory in an unmodified TRS- 
80 is 450nS; with the speed-up modifications 
presented in this book, that figure drops to 300 
nS or less. 

Most of the current crop of memory chips 
easily meet the 450 nS requirement, and many of 
those sold as 450 nS chips can be run reliably at 
300 nS. A problem arises with the expansion 
interface, as older units had a bit of trouble with 
'hotter' (faster) memory. So as a general rule, 
refer to Table 4-2 when looking for memory to 
upgrade your TRS-80 or its expansion interface. 



Equipment 



TRS-80 keyboard unit, unmodified 
TRS-80 keyboard unit with speed-up 
Expansion Interface mode before 1/80 
Expansion Interface made efter 1/80 
Expansion Interface made before 1/80 

with speed-up 
Expansion Interface made after 1/80 

with speed-up 



Access Time 

450 nS max, 350 nS optimum 
300 nS max, 250 nS optimum 
300 nS min, 450 nS max 
450 nS max, 350 nS optimum 

300 nS min optimum 

300 nS max, 250 nS optimum 



Table 4-2. Memory access time for various TRSSOs. 



Opening and Closing the Case. 

1. Locate a spacious workplace, and set a 
soft towel on it. You will need a Phillips 
screwdriver and a small box in which to set 
the screws and spacers. 

2. Remove the power and disconnect all 
cables to the keyboard unit. Set it face down 
on the towel. 




Photo 4-1. Photos showing opening computer. 



Unit is placed face down and screws are removed On newer 
units one screw is beneath a warranty notice. 

3. There are six screws of three different 
sizes which hold the case together. In later 
TRS-80's, one of these is covered by a label 
warning you not to go inside. This label just 
won't peel off for later use. You'll have to 
punch through it to remove the last screw. 

4. Hold the case together and place it face 
up on the towel. Gently lift off the top cover. 

Some TRS-80's have a 'flying lead' LED 
(light-emitting diode) power indicator, 
meaning you will have to pull it gently out of 
the hole in the top cover. Other power 
indicators are fastened to the keyboard, and 
the cover lifts off directly. 




Computer is placed face up and the top removed by lifting back 
and up. 
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5. This step is the most delicate. Lift the 
keyboard slightly upward, and then swing it 
toward you. A cable attaches from the 
keyboard to the main circuit card at the 
bottom left side. This cable is made up of 
flat copper bands which have a tendency to 
break when flexed. 




Keyboard is rocked gently forward to show white plastic spacers, 
which are then removed. 

6. While holding the keyboard up at about e 
90-degree angle, look at the main circuit 
card. There are five soft plastic white 
spacers which cushion the keyboard. On 
later models, a sixth, central spacer is hard 
plastic. Note their positions, remove them, 
and set them in the parts box. 

7. Swing the keyboard downward gently, 
and lift the entire computer out of the base 
of the cabinet. Set the computer down and 
put the base aside. 




8. Most modifications will be done to the 
integrated circuit side of the circuit board, so 
turn the entire unit face down again. Unless 
the modification calls for work on the solder 
side of the board, do not flex the keyboard 
cable again. 

9. If the modification calls for work on the 
bottom of the board, get a heavy box or 
other support. Set the keyboard face up, 
and swing the keyboard out and up a bit 
wider than 90 degrees, leaning it against the 
support. Never open the unit fully like a 
book, as this badly deforms the interconnect 
cable. 




With the keyboard supported upright against a firm backing, the 
CPU board is lifted from the case bottom. 



The complete unit is ready for work with the keyboard supported 
at a 90-degree angle. 



10. To close the case, fold the unit back 
together, and set it into the base. The unit 
may have to be jostled gently to get it to fit 
over the plastic support posts. Make sure 
any added wires do not get caught and cut 
by the support posts. 

11. Lift the keyboard slightly and restore 
the white spacers to their former positions. 
Fit the keyboard back into place. 

12. If any long wires or cables have been 
added, make sure they all clear the cabinet 
edges. Restore the LED to its place on the 
keyboard top if it is a flying-lead type, or 
straighten the LED on the circuit card so it 
fits into the cover hole. 

13. Fit the cover into place lightly, making 
sure there are no newly installed parts being 
crushed or bent in the process. Be sure no 
leads creep out the joints on either side. 

14. Holding the unit together firmly, flip it on 
its face. While holding it with one hand, drop 
the screws into the holes, longest one towards 
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the top. Fasten one screw on either side; this 
will hold the computer together while you 
tighten the remainder. 

15. Remember that the case is soft plastic, 
so just tighten enough to pull the two sides 
together. Otherwise, the plastic may be 
stripped and the screws will fall out. If that 
happens, drop in some clear acrylic cement 
(not white glue), and insert the screw. 
Remove it just before the glue hardens, and 
replace it about an hour later. 

16. Flip the computer on its back, restore 
cables, and turn on the power. If the 
slightest problem seems apparent, open up 
and try again! 



Tips on Handling Integrated Circuits 

In the early days of microcomputers, there 
was a lot of user hesitation about installing 
memory chips because of warnings about static 
electricity damaging the memory devices. At 
that time the fear was reasonable; but today 
(with just a little caution) there need be no 

problem. 





I: I :| 

Photo 4-2. Memory chip area in TRS-80. 

Power Supply and Memory: 2N5594 transistor handles 5-volt 
supply; adjustments are seen at top of photo. 1 6K RAM chips are 
plugged into sockets Z13 to Z20, unusually close to the power 
transistor's heat sink. Replacement memory chip in socket Z13 
attests to the degrading capacities of excess heat 



Figure 4-1. Grounding a soldering iron. 



1. Never place any integrated circuit on highly 
charged plastic material, especially styrofoam. 



2. Handle memory chips, CPUs (such as the 
Z-80), LSI devices (large-scale integrated 
circuits, usually those with 28 or 40 pins), or 
any marked MOS, CMOS, or NMOS 
(metal-oxide semiconductors), with care. 
Hold them by their ends, never by the 
connection pins. 

3. Purchase a static-free workbench, which is 
a conductive cloth sheet with a wrist strap 
and safe grounding cable. These can be 
obtained from Wescorp for about $18. 

4. Ground your soldering iron to an earth 
ground but only through a series-connected 
one-megohm resistor — never directly! The 
grounding is not absolutely essential, but 
helps if you live in a very dry, static- 
producing environment. 

5. Work with any integrated circuits with the 
power off. Make sure the integrated circuit's 
ground and power pins are all connected 
(soldered or in sockets) before turning on the 
juice! A difference of a mere half a volt 
between certain pins can kill an IC. 

6. Use high-quality sockets for integrated 
circuits wherever you can. This will not only 
keep excessive heat away from them, but will 
also save the day if one is damaged. 
Unsoldering a 40-pin integrated circuit is not 
pleasant. 

7. Above all, work slowly and carefully. By 
far the greatest villain is haste. Oh yes — do 
keep furry animals out of the area! 
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Level I ROMs: Rockwell single-chip ROM and Motorola 2-chip 
set are pushed into aluminum- foil- covered vegetable tray. 



Before installing your new memory chips, take 
a styrofoam meat or vegetable tray, trim off the 
curved ends, and cover the center with aluminum 
foil. This will be your static-free storage for the 
4K memory chips you will be removing. To 
install the 16K memory in your keyboard unit, 
turn off the power, open the case and find the 4K 
memory chips. 

Slide a thin-bladed screwdriver under the end 
of one of these chips, and rock it slighly upwards. 
Slide the blade under the other side, and rock. 
Move back and forth gently until the chip is free, 
but don't spring it out of the socket. Lift it by the 
ends and press it into the foil-covered tray. As 
you are doing this, notice that each of the chips 
has a notch or dot at one end. Keep this position 
in mind; the 16K chips will be installed in the 
same direction. 



v ^j f " ~1 v^- 







LEVEL II 


LEVEL II 


A BOARD 


1ME 


3-CHIP SET 





A.DfcG BOARDS 



LEVEL IUI 
A, CMS SOAHDS 



Figure 4-2. 16K RAM expansion shunt versions. 



Once all the 4K chips have been removed, lift 
the 16K chips one at a time and press them in the 
empty sockets. If the pins are spread too wide, 
set the chip sideways on the foil-covered tray and 
press gently. Try again to insert the chips. Be 
sure none of the pins are bent underneath, or 
slide outside the socket. 

Now turn your attention to a pair of on-board 
sockets marked Z3 and Z72. 16K chips will need 
more attention from the address lines, so these 
decoding shunts will have to be changed. If you 
didn't receive these shunts with your order of 
16K chips, have no fear — just slide wires into 
the sockets. Or, obtain an 8-position DIP switch 
and push it into the socket. Turn the switches 
on where the shunt is to be connected, off where 
the bars are broken. Figure 4-1 shows the old 
and new positions of the shorting bars or wires of 
these shunts. 

When you have placed the new, corrected 
shunts, switches or wires into sockets Z3 or Z72, 
and all the 16K chips are installed, the keyboard 
upgrade is complete. Reinstall the computer in 
its case, turn on the power, and press (ENTER) 
in response to MEMORY SIZE? Then PRINT 
MEM, and you should see a value of 15572 (15570 

on newer machines). If you don't get that value, 
turn the machine off and troubleshoot: 

1. MEMORY SIZE? reads much less than 
15570. Turn off the computer and try again. 

If you have no expansion box, type SYSTEM 
(ENTER) /0 (ENTER), and keep trying. If 
the value never changes, you may have either a 
bad memory chip or incorrect shunt wiring. Go 
back to MEMORY SIZE?, only this time enter 
15560. If you get the READY message, this 
might point to a failed memory chip or an 
incorrect DIP shunt (especially if PRINT 
MEM? reads the same as that for 4K). To test 
memory, run the RAM test printed in Chapter 3. 
If instead you get the flash of an ?0M ERROR 

and a return to MEMORY SIZE?, then suspect 
that you've wired the shunt or shorting wires 
incorrectly. 

2. You get a partial RADIO SHACK LEVEL 
n BASIC (or R/S LEVEL 2 BASIC) message, 
with or without READY, and with or without 
incorrect characters, but it only lasts for a 
short time before crashing back to MEMORY 
SIZE? 

Suspect that a memory chip is very balky, is 
inserted only partly or with pins bent, or that 
you've lifted the Level 13 interconnect cable (if 
your unit has one). You may also have damaged 
some other circuitry, but this is very unlikely. 
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3. The screen never gets past a pile of 
garbage. 

You may have lifted the Level II interconnect 
cable (if your unit has one), one or more memory 
chips may be completely dead, inserted 
backwards or only partly, or you may have 
forgotten to reinstall (or have reversed) either of 
the two shunts at Z3 and Z72. 

4. Unexpected characters are displayed after 
MEMORY SIZE?, sometimes acting as if 
they were 'entering' themselves. 

You have broken one or more wires of the 
keyboard interconnect cable. You can look for 
cracks, or just replace the whole cable. 

5. The machine responds correctly, but only 
for a short while; it often crashes; occasionally 
PRINT MEM will give a smaller number 
than 15570, but not always. 

This is probably balky memory or memory 
that is the wrong speed (usuaily older, slower 
memories that some discount houses may sell). 
For starters try reinserting the memory in case of 
a bad contact; run the RAM test; or just buy 
new memory. 

6. The computer displays a screen full of 999, 
etc. 

You have lifted the Level II interconnect cable 
out of its socket. Replace it very carefully. 

Adding to the Expansion Interface is a much 
easier task. Your keyboard unit must have 16K 
in it already in order that the memory map be 
complete from 4000 (decimal 16384) to the start 
of expansion box memory at 8000 (decimal 
32768). And, sadly, you cannot use your 4K 
chips in the expansion box without a hardware 
modification. 

First, remove the cover over the power 
supplies and remove them; this will prevent 
them from tumbling all about when you open 
the bottom cover. Now flip the expansion box 
over and remove and set aside the six screws that 
fasten the cover. Also disconnect the power 
cable inside the expansion interface case. 

Inside, you will find two rows of empty sockets 
for memory expansion. The first 16K of 
expansion memory goes in the sockets marked 
Z9 to Z16, and the second 16K into sockets Zl to 
Z8. The memory must be inserted in this order, 
unless you want a permanently protected, 16K, 
high-memory block (which might be useful). 
Use the same procedure for installing these 
memory chips as for the keyboard unit, facing 
them in the direction of the notch on the sockets. 
Once again, check carefully for bent pins or pins 



out of the sockets, reinstall the cover, and power 
up the interface and keyboard. 

Press ENTER in response to MEMORY 
SIZE?, and your 32K machine should read 
31956, and the 48K machine will read 48340 (two 
bytes less each in later models). Early 
expansion boxes, because of design flaws in 
memory timing, are significantly more sensitive 
to memory speed. If expansion memory is 
occasionally balky or shows frequent glitches 
when peripheral devices are attached, make the 
hardware changes to Z69 recomended in the 
200% speed modification (later in this Chapter). 
Seeming memory failures can most often be 
attributed to these timing problems, although 
earlier interfaces (particularly those with the 
bulbous buffered cable) had hardware 
difficulties which made them extremely 
sensitive to noise and vibration. 

Most of these earlier units had their circuit 
board layout and plating done in such a way that 
a sharp tap on the box, board, or cable would 
cause a 'microphonic' reaction. That is, the 
vibration would be transmitted along power 
supply and signal lines, interfering with the 
actual data. The result would be frequent 
memory crashes. Likewise, a noisy environment 
(nearby washers, mixers, fluorescent lights, 
transformers, and even printers) can cause 
electronic interference which would disrupt 
memory. 

Rescuing the RESET 



Among the conveniences of the TRS-80 
keyboard computer is the Reset button. A 
program, especially one with machine language 
components, may cause the computer to 'hang'. 
The Reset button conveniently recovers control 
of the machine and returns it to you. 

Once the Expansion Interface is connected, 
though, things begin to change. The Reset 
button becomes a Reboot button, causing any 
operating programs in memory to be lost and the 
complete system to restart from initialization of 
the disk operating system (see Supplement to 
Chapter 1, on the power-up sequence). 

As an aside, let me note that the Z-80 HALT 
instruction does not have the effect of a true 
HALT. Instead, the CPU's Halt Acknowledge 
output line is tied in with the Reset button. The 
result is a READY in Level II and a disastrous 
reboot with an expansion box connected. This is 
another good reason for reasserting the Level II 
reset function with this modification. 
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Up-Front RESET 




The solution to this problem is to disable the 
disk controller whenever disk access is not 
expected. Open the expansion box, and locate 
Z32, near the power switch. If you have a newer 
expansion interface, this circuit will be marked 
Z39. This is a 16-pin circuit, type 74LS155. 
Identify the circuit trace that runs from pin 4 
underneath the IC and out the opposite side. Use 
an ohmmeter if necessary to make sure you have 
the right trace. This signal activates the disk 

controller chip's output to the CPU; when it is 
cut, the keyboard unit cannot 'see' the disk 
controller. 

Take a sharp blade and cut this trace. Solder a 
10K ohm resistor from the far side of this trace to 
pin 16 of Z32 (or Z39). This is the +5 volt lead, 
and will hold the pin high. 

Next run a pair of fine wires from either side of 
the cut trace to each connection of a small toggle 
switch. When the switch is on, the cut trace is 
bridged, and the disk controller buffer can be 
activated normally; when the switch is off, the 
Reset button sends the software to a routine that 
checks for a disk controller. Since it does not 
'see' the controller, it acts as if it were simply in 
Level II BASIC and returns to READY. 

Be sure to mount the switch as close as possible 
to the trace cut, preferably right on the front of 
the expansion box, as shown in Photo 4-1. This 
will prevent noise from creeping in to an already 
somewhat noisy box. 




Photo 4-3. Expansion box reset modification. 



Visible in this photo are a 12-inch replacement expansion cable, 
and the disk-defeat switch to recover the reset function. 



The LNW expansion interface change would 
normally be identical to that for the Radio 
Shack box, except for the integrated circuit 
numbers. One additional change is necessary. 

The trace from U19 pin 4 leading to U8 and 
U15 is cut, and a 10K resistor wired from the 
trace end closest to U8 and U15 to +5 volts 
(found at U19) pin 16). 

However, the pullup/pulldown resistors in the 
LNW expansion box can still give an 'on' 
reading to the CPU. To avoid this, change the 
pulldown resistors from 220 ohms to 470 ohms 
(or, if they already are 470 ohms, from 470 ohms 
to 680 ohms). This will result in the 'high' 
reading needed to avoid picking up the disk 
controller signal. 

Up-Front RESET 

If you are a frequent user of the Reset button 
in Level II — and once again a user of it with 
your expansion box — then you will want to get 
the button out of the area of the sensitive 
interconnect cable, and well within reach. It will 
be a welcome relief from clawing at the silver 
port cover, or totally wiping out your program by 
jostling the cable. 




3. AW THIS WITCH. 

Figure 4-3. Expansion box reset modification. 




Figure 4-4. Up-front reset addition. 



92 



Working by the Woodstove 



A momentary-on pushbutton (such as Radio 
Shack part number 275-1547) can be added to 
the cover of the keyboard unit. Photo 4-2 shows 
the position of the Reset button on the left side 
of the computer. Run two wires from the 
pushbutton to a small cable connector (a 
submini plug), and run two wires from the Reset 




Photo 4-4. Up-front reset addition. 



Reset switch added to the top cover. A connector is added so the 
cover can be removed easily. 




MIIIH 



Piggybacking sequence: pins are removed from short solder- tail 
socket, and it is used as a grommet for a wire-wrap socket. After 
this is soldered to the baseboard, a third socket is plugged in 
place. 




button (see Figure 4-2) to the other end of the 
cable connector (a submini jack). The project 
can be completed in ten minutes, carpentry and 
all, and reset will be less frustrating. 

Note : Don't risk being a victim of the Apple 
syndrome! Apple's Reset button is placed much 
too close for comfort to the user's work area, and 
many a program has disappeared into the 
electronic stratosphere when inadvertently 
pressed while typing. So keep that Reset button 
just out of reach! 



Working by the Woodstove 

There comes a time when sitting up straight by 
the computer is no longer fun. Or when the 
neighborhood kids howl because they can't all 
reach the keyboard at once during an action 
game. Or when those kiddie hands are just too 
sticky for your sacred micro. Or, in my case, 
when the computer's room is just too cold to 
share with my typing fingers. That's when you 
need a keyboard and monitor in the room by the 
woodstove. Or an extra keyboard for the 
young'ns. Or a keyboard for the lap in an easy 
chair and a monitor on the mantle. 

The additional keyboard is mostly a matter of 
carpentry, because there's nothing special about 
the TRS-80 keyboard. It's merely a matrix of 
switches, eight by eight. Each position in the 
matrix is identified by the computer's software 
and turned into a character. 

Start by obtaining two high-quality wire-wrap 
integrated circuit sockets, and one good 
solder-tail type. These are 16-pin sockets. You 
will also need fine wire, a 16-wire jumper cable 
with plug attached, and a keyboard. 

The keyboard can be any style you like, from a 
complete alphanumeric keyboard ($40 to $120), 
to a $10 numeric keypad if you work mostly with 
numbers. Whichever you choose, it must consist 
of individual keys, each with a single-pole, 
single-throw (SPST) contact pair. Many small 
calculators have a prearranged matrix which is 
incompatible with the TRS-80. If you choose a 
matrix keyboard, check that it will work with the 
TRS keyboard pattern shown in Table 4-3. 
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Since depressed keys are identified in software 
by the row and column, you only need to know 
which column -row combinations produce the 
letter you want. That way, you can reassign your 
keyboard's characters for any purpose that suits 
you - including the Dvorak keyboard. Thus, you 
need make nq software modifications to your 
favorite machine language programs to use them 
with different keyboard combinations. 

Furthermore, the attachment of a 64-key 
musical keyboard can open the door to direct 
compiling of music as you play it. 

The physical layout of the TRS-80 keyboard 
unit is fairly compact, leaving only a space on the 
far left or far right for the added keyboard 
connection. I have chosen the left side for that 
addition. Inside the computer, this location is 
directly above a blank part of the keyboard's 
circuit card. 

Use a strong flat screwdriver to snap out the 
black portion of the keyboard cover. Six tabs 
hold it in place at the top and bottom. Mark 
precisely where the free area can be found on the 
baseboard. 

You will be using the three IC sockets to make 

a standoff -style keyboard connector. Pull all the 
pins from the solder-tail socket, and use this 
socket as a guide to drill 16 holes in the 
baseboard. Use a very fine hobby drill — #68 is 
good. When you have the holes completed, slide 



one of the wire-wrap sockets into the 
disemboweled solder-tail socket, and feed the 
wire- wrap pins through the circuit board. 
Fasten with fast-drying epoxy; do not use white 
glue, as this will react badly with metal. 





Plastic carriers from flat-pack integrated circuits make excellent 
'bridges' to hold wires in place. A drop of glue holds them there. 

When the glue is set, remove the entire 
keyboard cover, turn the baseboard over, and 
identify pin 1 of the newly installed socket. This 

pin will attach to column one of the keyboard 
matrix (see Table 4-4). On most versions of the 
TRS-80, you can use the keyboard's resistors to 
identify the columns; I recommend this, because 
there were at least three separate runs of 
keyboards, each with a different layout. 



Colunn 
Column 
Co Lunn 
Column 
Colunn 
Colunn 
Column 



RB 
R5 
R3 
RB 
R7 
R1 
R4 
R6 



• HP 
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L T 

M U 

N V 

W 



B ENTER SHIFT 
9 CLEAR 
: BREAK 
; UPARROW 
, OOWNARRQW 
- LEFTARROW 
. RIGHTARROW 
/ SPACE 



The extra keyboard socket is soldered in place, with the gutted 
solder-tail socket used as a grommet 



Table 4-4. Keyboard column assignments. 

Match column one, then, with socket pin 1; 

column two with socket pin 2; column three with 
pin 3; etc. Solder a separate wire to each of the 
resistors, and wire-wrap or solder the other end 
to their respective socket pins. Make sure you 
solder to the end of the resistors which are 
connected to the keyswitches, not the other ends, 
which are all connected together. 

The keyboard matrix rows are found at the 
input pins of the on-board ICs, but because of the 
many versions of the TRS-80 keyboard which 
have been issued, this sequence is inconsistent. 
The technical manual identifies the rows as 
shown in Table 4-5, but it's better to check for 
yourself. Look for the traces that connect 



94 



Working by the Woodstove 




The extra keyboard socket is soldered in place, with the gutted 
solder-tail socket used as a grommet 





Socket rises perfectly to the height of the outer shell Note reset 
button extension at left 




Completed extension cable plugs discreetly into the socket Any 
type of keyboard, from a small numeric pad to a full 64-key 
musical keyboard, can be used. 



together @, A, B, C, D, E, F and G. These are all 
in row one. Solder a wire to some point in this 
row, and run it to pin 16 of the new keyboard 
socket. 



Row 1 
Row 2 
Ron 3 
Row 4 
Row S 
Row 6 
Row 7 



Row 8 
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Table 4-5. Keyboard row assignments. 

Locate row two by using Table 4-5, and solder 
a wire from somewhere in this row to pin 15. 
Likewise, identify rows three through eight, and 
solder them to pins 14, 13, 12, 11, 10 and 9, in 
order. When viewed from the top, the pin 
arrangement is as shown in Figure 4-4. 



Figure 4-4. 



r 



TOP OF JUWER SOCKET 




J 



Once the wiring is complete, clip the pins on 
the added socket very short, turn the board over, 
and put everything back in the case. Power up 
and check the operation of the computer. 

Now clip a small length of bare wire about an 
inch long, and bend it in the shape of a 'U'. At the 
newly installed socket, jumper each row across to 
each column, one at a time. You should produce 
all the non-shifted keyboard characters on the 
screen, including the previously inaccessible four 
arrows and the cursor character. 

Clip an additional jumper, and cross row eight 
with column one. This simulates the pressing of 
the SHIFT key. Repeat the column-row 
jumpering, and note that all the shifted 
characters now appear. Any unusual behavior, 
such as repeated letters or groups of unrelated 
letters produced from a single jumpering, 
indicates a wire may be shorted, attached to the 
wrong column or row, or left out completely. 

Finally, as with all modifications, make the 
cosmetics pretty. Snap the black plastic cover 
off again, and in it cut a rectangular hole the size 
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of the 16-pin socket, using a hot, sharp X-acto 
knife or razor blade. Work slowly, filing or 
smoothing, and rub the finished hole with a 
marble. This will result in a professional- 
looking addition. 

The second wire-wrap socket now piggybacks 
into the first one, and the black cover snaps back 
on. The socket should fit perfectly, rising about 
1/16 inch above the surface of the cover. The 
16-wire cable plugs into it a comfortable distance 
from the typing area, well above and to the left of 
the up-arrow key. 

For each keyboard you wish to add, work out 
the row-column matrix using the table. A jumper 
cable may be an integral part of each keyboard, 
or an IC socket'lug arrangment similar to the 
main unit can be included with each added 
keyboard. You can even chain keyboard to 
keyboard by including two sockets on each one - 
just be sure all the sockets and plugs are 
identically wired! 

Working by the Woodstove - II 



Once you've got a new keyboard in your lap, 
you'll probably want a nearby screen to glance 
at. There are two ways to do this: by using a 
video monitor or by using an ordinary television. 



There are advantages and disadvantages to both 
methods. 

A video monitor is the ideal tool because the 
image is crisp and clear, and your TRS-80 
provides a 'composite video' (video with both 
image and synchronization signals) output. But 
a video monitor also costs somewhat more than a 
new black and white television, and means an 
added expense in any case. 

A television on the other hand has limited 
'bandwidth'; that is, it was made for fluctuating 
images, and not for the precise on-off quality of 
white letters on a dark background. If you've 
ever noticed that it's sometimes hard to read 
telephone numbers, addresses, or credits for 
television programs, you've got an idea of how 
hard it can be for some sets to reproduce crisp 
computer lettering. 

Furthermore, most televisions accept only 
radio frequency (RF) input, meaning your 
TRS-80 output has to be converted to RF before 
your television can make sense of it. The last 
complication is that such a close and strong RF 
signal can overload your television's automatic 
gain control (AGC) resulting in an unstable, 
twisting, rolling, or badly contrasted picture. 

But chances are you already have a television, 
and chances are even better that the television is 



Making it Look Manufactured 

One of the worst curses of a customized 
anything is how it tends to look - homemade. 
Now I have absolutely nothing against 
something looking homemade, but whenever I 
do that, somehow it also acts homemade - that 
is, just a bit too eccentric to be reliable as a 
computer! 

Instead, attend to the cosmetic aspects of the 
TRS-80. Since the plastic case is very pliable 
and 'works' easily, these touches are easy. The 
silver coloring is a flake paint, and tends to 
wear off, particularly below the shift keys 
where the typing hands rest. The black plastic 
cover is very soft and can be scratched; its 
pebbled surface makes such scratches stand 
out. 

If the silver flake paint wears off, it can be 
resprayed with the kind of paint used on model 
cars. Work the spray can valve for a while until 
it is spraying evenly, and then spray the silver 
cover from a slight distance. If the color match 
is not perfect, the bottom can be sprayed as 



well. Use two or three extremely light coats for 
a good effect. 

The black plastic cover can even have deep, 
obvious scratches repaired by rubbing it with a 
glass marble. The scratch will smooth over, 
making it different from the area around it. 
Next, pick at the smooth area very lightly with a 
needle, making pebble-size marks similar to the 
rest of the case. Rub with the marble again until 
the scratched area looks exactly like the 
surrounding area. It really works. 

When cutting holes for switches, buttons, 
sockets, jacks, keypads, etc., always cut the 
holes slightly smaller and use rattail (for round 
holes) or triangular (for rectangular holes) file to 
expand it to the correct size. This way, no 
unsightly cut marks will extend away from the 
area of the modification. Bevel cut rectangular 
surfaces with a flat file, smooth them with a 
letter opener or librarian's 'bone', and touch up 
the corners. The result will be almost precisely 
like the manufacturer's molded cutouts. 
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Figure 4-5. Extra video jack 




Photo 4-1. RF modulator hookup. 



Additional jacks added in order to feed both the video monitor 
and an RF modulator installed in the expansion box. 





□ 




Photo 4-6. Extra video jack. 



just where you were thinking of using your 
computer. 

Before going on with these modifications, 
there is one important note. Working with any 
unknown television or monitor can crash your 
system if it is electrically noisy. If you plan to 
send a video signal directly to a monitor, or 
especially to a television modified for video 
input, make sure the set isn't 'hot' - no AC line 
voltage should be floating on the case. This can 
damage your computer ... or you! If you are 
considering a monitor or direct video input, and 
you are not familiar with your video sets, then 
take the television or monitor to a service person 
who can check them out. With appliance devices 
such as ordinary televisions, this is doubly 
important. This note does not apply if you will 
use RF input to a television. 

Whichever method of added video you decide 
upon, though, there is a solution. The first and 
easiest is to add an extra video output jack to 
your computer. There's plenty of video signal to 
be had, and it can be shared among several sets. 
Figure 4-5 shows how to wire that extra jack, 
and Photo 4-6 shows how mine is installed. The 



Figure 4-6. RF modulator hookup. 
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Hexadecimal Keypad 





connector shown in the photo is a miniature 
Amphenol connector used for microphone cable, 
although any kind of microphone, video, CB, 
phono, or other shielded coaxial cable and 
connector can be used. 

A second approach is to send the computer's 
video signal to an RF generator, and feed that to 
your television. An RF modulator is available in 
kit form from Radio Shack (part number 277- 
122, with TRS-80 installation instructions) and 
also from other suppliers. A few plugs and jacks 
are needed to complete the job. 

Assemble the kit or purchase a surplus 
modulator, and hook it to an ordinary television. 
Either run the new video output to the 
modulator's input (use the directions with your 
modulator), or install a separate DIN 
plug-and-jack pair as in Photo 4-7.). 

Actually modifying an ordinary television for 
video input is tricky, and I won't cover the topic 
here. If you are interested in doing this — and 
picture quality will be very much improved — 
refer to Don Lancaster's TV Typewriter 
Cookbook. 

The results of your video modifications will be 
dependent on how clean your soldering is, the 
layout of your wiring, etc. If you add the RF 
modulator, you may notice something similar to 
herringbone on your TRS-80 monitor if the 




Photo 4-8. An Extra system near the woodstove. 

The kitchen installation. An old RCA television and a surplus 
keyboard make working with the TRS-80 more convenient 
Computer remains in one place, but extra monitor and keyboard 
can be moved closed to the woodstove on cold days. The 
woodstove offers no electronic interference. 



contrast is turned all the way up. Move the 
modulator away, or put it in a shielded (all metal) 
box, and the herringbone will disappear. 

If you use a long cable directly from the video 
output, there will be a huskiness to the characters 
on your TRS-80 monitor. This is actually a kind 
of 'smearing' introduced by the capacitance of a 
long cable. This is not bothersome to me; in fact, 
it actually seems to improve the clarity and 
boldness of the screen characters. 

Finally, if your RF-input television addition 
results in an unpleasant display on the TV, try 
to adjust the automatic gain control (AGC) on 
the back of the set. Tune it in carefully as well. 
There will probably be less clarity in the 64- 
character mode than you are used to with your 
monitor, unless you have a very good set. 

Hexadecimal Keypad 

Entering machine language programs using 
T-Bug or another monitor is tedious enough 
without having to search all over the QWERTY 
keyboard for hexadecimal numbers. Instead, a 
keyboard can be added right onto the TRS-80. If 
you have a numeric keypad included with your 
Level II unit, you might want to remove it to add 
this one. 

The addition of a hexadecimal keypad is 
mostly carpentry, since the connections are made 
in parallel to the main board, exactly like those 
connected to the socket addition described 
earlier. An unencoded hexadecimal keypad to do 
the job is available from Jameco Electronics (see 
Appendix 1 .), and one of its keys can be set aside 
for an Electric Pencil or other control key, 
adding significant programming power to your 
custom TRS-80. 

For this modification, you will need two 10- 
inch strips of 1/2-inch by 1/2-inch plastic rod 
(plexiglas or lucite are best, but wood strips will 

work as well), five-minute epoxy, wire, and the 
notorious hot razor blade and marble for the 
cosmetics. 

Undo the cabinet as usual, and take the entire 
electronics out of the case. Later TRS-80's have 
an on-board, two-chip Level II ROM set, but if 
your Level II ROMs are the type on a separate 
board fastened to the end of an interconnect 
cable, then they will have to be moved. They are 
fastened to the bottom right of the circuit card 
with double-face tape; slit the center of the tape 
with a razor blade. Do not pull the ROM board 
off by force, as the pressure might crack either 
circuit board. 
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Photo 4-10. 
template. 



The interconnect cable to the ROMs is long 
enough so they can be remounted inside one of 
the case 'feet', or above the hexadecimal keypad. 
Pick up a small piece of double-face tape to 
refasten them, or roll masking tape into cylinders 
(remember hanging pictures in fourth grade?). 

The Jameco Electronics keypad base is 
identical to the TRS-80's in height and depth, so 

Black plastic cover used as 




Photo 4-10. Black plastic cover used as template. 

The black plastic keyboard cover can be snapped out and cut to 

fit A paper template is used first to verify the position of the hex 

keypad 



Cleaning the Keyboard 

If your TRS has the old-style keyboard that 
was badly afflicted with keybounce, there are 
many ways to take care of it other than 
perennially loading a KBFIX routine. 

The first rule is to make sure you have the 
old style keyboard! The newer keyboards have 
a sculptured curve to their arrangement when 
viewed from the side. These new boards have a 
contact arrangement which can be destroyed by 
trying to remove the keycaps. But these 
keyboards don't have a keybounce problem 
anyway. 

Bend a paper clip into an ingenious keycap 
lifting tool, like this: 




Figure 4-7. Keycap lifting tool 

Slip this clip underneath a keycap, and lift 
up. The plastic cap will come off, revealing a 
hole in which two metal plates are protruding 
upward. 



the two plastic strips can be used to create a 
'trailer hitch' arrangement with the smaller 
keyboard. Support both boards firmly so that 
they are parallel and the hex pad meets the 
TRS-80 printed circuit base. Cement the plastic 
strips in place with the quick-setting epoxy, and 
make sure the vertical alignment of both 
keyboards is identical. If you have a later style 
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Keyboard is attached with runners to the main keyboard, and 
glued in place with epoxy. 



The best way is to test the keys. Press each 
key quickly, gently, slowly, or sharply, until you 
decide whether it is a 'bouncy' key. If it still 
bounces after the cleaning, then take a hatpin 
(are there still hatpins?) or heavy sewing 
machine needle, and push the tines in line. 
This is a very delicate job; use caution and a 
magnifying lens. If the plates are not parallel 
to each other, or if they are vertically 
misaligned, use the pin to shift their positions. 

The villians are dirt and bent tines on the 
plates. Brush out the dust, dirt, or hair (or much 
better, blow it out, using photographers' 
compressed air, such as 'Dust-Off). You will be 
amazed at the cloud of grit that rises from the 
keyboard. Next, examine the tines of each key 
very carefully. They should be perfectly in line, 
so that when a key is pressed, all come into 
contact with their opposite (un-tined) plate. 

Check all the keys for bounce again, and 
work until it is completely cured. Some folks 
recommend a spray of contact cleaner at this 
point; I recommend against it. The cleaner 
tends to stay wet for a while, and dust and grit 
can get back into it very quickly, collecting into 
a dusty mudpile. Instead, give all the keys a 
last brushing or spraying with compressed air, 
and fit the keycaps back on. 

Keybounce should be gone for quite a while. 
Monthly cleaning will keep the keyboard in 
shape. 
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keyboard (with the curved keyboard array), you 
will have to adjust the carpentry slightly. You 
may also experience a bit of keybounce on the 
new keyboard unless you keep the keys clean. 

When the glue has set, use the black plastic 
cover as a template for drawing your current key 
positions and, with the aid of a straightedge, 
draw extension lines horizontally across that 
drawing. These are the upper and lower limits of 
the new keypad opening. Align the template with 
the complete alpha/hex keyboard assembly, and 
mark the vertical positioning of the hex keys, 
allowing about 1/32 inch additional on both sides 
for key-travel room. This will bring you within 




Back of keyboard is wired by soldering directly to the key pins. 
Wires are then run to resistors and integrated circuits found on 
the main keyboard 



1/4 inch of the power LED. 

Using the template with the black plastic 
cover, carefully cut an opening in the cover with 
the hot razor blade. This is the most 
time-consuming task, and should be accurate 
enough for the keys to travel easily (fit it atop the 
keyboard before re-installing the modified 
computer), and should look factory-finished. 

It's about time to interconnect the wires from 
the hex pad to the main keyboard, but before 
that, you'll probably want to rearrange the 
keycaps on the hex pad. Using the lifting tool, 
pull off the keycaps and put them in a convenient 
order for hex entry; I used the accounting 
arrangement, bottom to top. This is the pattern 
used for the wiring arrangement shown in 
Diagrams 4-1 and 4- 2. 

Rest the keyboard on its face, and separate it 
gently from the main circuit card. Set the 
keyboards in an accessible position, and solder 
fine wires (wire-wrap type is easiest to use) to the 
hex pad connections shown in Diagram 4-1. 
Route the individual wires from the hex keys to 
the points on the circuit card shown in Table 
4-5. As before, check to make sure this IC 
arrangement matches your board. 

Next, solder wires to the hex pad contacts as 
shown in Figure 4 - 1 , and route these wires from 
the hex keys to the circuit card's resistors noted 
in Table 4- 4. Double check these too against 
your version of the keyboard. Once both sets of 
wires have been run, gather them in neat hanks 
and fasten them along their routes with wire ties 
(plastic bag ties will also work well). 




Completed keyboard seats easily in the case bottom. A piece of 
insulating plastic should be inserted under the added keyboard 
to prevent pushing the keyboard pins into the main circuit board 
and causing a short 
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Level II ROM board can be fit immediately above the hex pad 
Insulating double-face tape can be used to hold them in place. 
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Reassemble the keyboard in its case, 
remembering to orient the Level II ROM board 
safely in its new position. Reinsert all cables, and 
restore power. The keys on the main keyboard 
should respond normally; check them all. Now 
check the keys on the hex pad. All but the 
bottom right one should have an effect. To test 
its operation, enter this program: 



10 CLS 

20 PRINT PEEK (14484); 

30 GOTO 20 



The value you read should be zero unless either 
the shift key on the main board or the bottom 
right hand key on the hex pad is depressed. The 
shift key will return a value of 1; the new key will 
display a value of 16. Pressed together, they will 
read 17. 

All keys should now be working properly. As 
with the socket addition described above, 
problems will occur in the form of incorrect 
letters, groups of letters on a single keypress, or 
dead keys. If any of these symptoms appear, 
recheck for shorted or unconnected wiring, or a 
difference in your model TRS-80 keyboard. 
Refer to Tables 4- 3 through 4- 5 if you suspect 
the latter. 



Hiiii\ 




The final modification with black plastic cover fit back in place 
looks manufactured (almost). 
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Reversing the Video 

The video display of most computers including 
the TRS-80 suffers from a tremendous flaw - 
contrary to what we have known since we first 
learned to read, the letters are presented to us in 
glowing blue-white on a black background. 
Serious use of a computer as a day-to-day 
appliance, as a true adjunct to our daily lives, is 
limited by its formidably unappealing, tiresome, 
and illegible display. 

The reverse video modification is surprisingly 
easy, so the question arises: why is it not a 
standard feature of small computers? The 
answer is found partly in a tradition of computer 
monitors which have always been lighted 
characters on a dark background. The 
remainder of the answer is found in the video 
display itself, which is more often than not 
incapable of presenting a legible character in the 
black-on-white mode. 

This problem arises with the TRS-80 as well; 
the video monitor has weaknesses which are 
emphasized by reversing the characters. But 
overall, and with a small change to the monitor 
itself, the display can be made quite legible and 
easy on the eyes. 

For this modification, you will need three 
integrated circuits: 74LS02, 74LS74, 74LS368. 

A 1.5K-ohm resistor will also be used, and wire- 
wrap wire for the interconnections. There are 
two ways of making this modification: on a 
separate board, or piggybacked atop chips 
already present inside the TRS-80. Since the 
latter approach would involve at least 15 
separate wires, both this change and the high- 
speed modification presented below will use the 
piggyback system. 

Open the computer's case, and remove the 




Normal screen has unnatural bright characters against a dark 
background, which is wearying on the eyes. 



electronics so the integrated circuit side of the 
main card is up. Locate the following circuits 
(the numbers are silkscreened on the board): 
Z22, Z26, Z27, Z30, Z52, Z53, Z54, and Z59. 

The output of Z54 (pin 8) is a decoded signal 
representing ports 254 and 255. Combined 
directly with the output of Z52 (pin 6), port 255 
is selected for use by the cassette and video 
circuits. By inverting the output of Z52 and 
combining it with the output of Z54 and the 
computer's OUT signal (Z22, pin 3), port 254 
can be selected. Figure 4-8 is the schematic for 
this complete decoding process. 

The decoder uses the 74LS02. Prepare the 
integrated circuit by bending all the leads 
except pins 7 and 14 so that they are parallel 
with the IC's body. Locate Z53 on the TRS-80. 
Seat the 74LS02 directly atop Z53, with both 
notches or dots facing in the same direction. 
Solder power pins 7 and 14 of the piggybacked 
IC to corresponding pins 7 and 14 of the one 
below. I will refer to this piggybacked IC as 
ZPORT. 



Figure 4-8. Reverse video schematic. 
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Find Z52. Run a wire from pin 6 of Z52 to both 
pins 2 and 3 of ZPORT, and solder it. Next locate 
Z54. Solder a wire from its pin 8 to pin 11 of 
ZPORT. Finally run a wire between pins 1 and 
12 of ZPORT. 

As mentioned, Z22 contains the needed OUT 
signal. Run a wire from pin 3 of this circuit to pin 
5 of ZPORT. Solder together pins 8, 9 and 13 of 
ZPORT, and run a wire between pins 6 and 10 of 
ZPORT. Pin 4 remains unused, and it contains 
the complete decoded signal of port 254 as shown 
in Figure (?). The BASIC command OUT 254,N 
will activate this signal. 

The next IC to be prepared is the 74LS74. 
Again, bend all leads parallel to the body except 
7 and 14, seat this upon Z26, and solder the 
power pins (7 and 14) in place. This 
piggybacked circuit I will call ZFLOP, as it will 
determine which state (normal or reverse video) 
is flip-flopped into place when OUT 254.N is 
commanded. 

Run a wire from the decoded signal at pin 4 of 
ZPORT to pin 11 of ZFLOP. Z59 has a 
convenient data line (bit 1) at its pin 5; run a 
wire from there to pin 12 of ZFLOP. Now run 
short wires connecting together pins 10, 13, and 
14 of ZFLOP. With these connections made, 
OUT 254,0 will flip the circuit, and OUT 254,2 
will flop it. (Is the suspense building?) 




Photo 4-11. Reverse video screen example. 



Illuminated background with dark characters is clear and, 
together with a green screen of some type, much more gentle to 
look at over long periods. 



The final IC is now prepared. Bend the leads 
of the 74LS368 parallel to its body, except for 
pins 8 and 16. Seat this on Z27 and solder power 
pins 8 and 16 to it. For convenience, this 
piggybacked circuit will be called ZMODE. 

Find Z30 and Z41. Pin 1 of Z30 is connected via 
a circuit board trace on the underside of the 
board to pins 6 and 7 of Z41. Z30 provides the 
characters to be output to Z41, which is part of a 
circuit that mixes in the synchronization 
information to produce 'composite video'. Cut 
this trace near Z30. 

Why cut this trace? The TRS-80 produces 
characters on the screen by turning on 'dots' as 
the electron beam sweeps across the tube. Each 
dot is part of a continuous stream of pulses which 
might be called 'dots' and 'undots' - ones and 
zeros. To reverse the video, then, all you need to 
do is to turn the 'dots' into 'undots', and turn the 
'undots' into 'dots'. We insert an electronic fork 
in the road at the output of Z30. When directed 
toward one side of the fork, the characters are 
made up of dots; when directed down the other 
fork, the characters become undots, and the 
background becomes dots. 

Run a wire between pin 1 of Z30 and pins 2 and 
14 of ZMODE. These are two inputs of an 
inverting buffer, the 'fork in the road'. If we 
invert the signal once, the video reverses . . . 
invert it twice, and the signal returns to normal. 
Connect pins 3 and 4 of ZMODE together to 
perform the double inversion. Pin 5 is the normal 
video output, and pin 13 becomes the reversed 
output. Connect both these outputs (pins 5 and 
13) together. 

Find the opposite side of the broken trace from 
Z30, and follow it to a hole that is plated through 
the board; it is at the end of a row outlined by Z29 
and Z30. Be careful to select the correct hole. 
Run a wire from this hole to pins 5 and 13 of 
ZMODE. This connection feeds both normal and 
reverse video back into Z41 and through to the 
video output jack. 



I have chosen ZMODE because it is a three- 
state circuit. That is, its outputs can be made 
electronically invisible. Otherwise, both normal 
and reverse video would be output at the same 
time. To choose between them, ZFLOP is used 
to enable one or the other of those outputs. Run 
a wire from pin 8 of ZFLOP to pin 15 of 
ZMODE. Run a wire from pin 9 of ZFLOP to 
pin 1 of ZMODE. 
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By commanding OUT 254,2 or OUT 254,0, 
data line 1 selects which output of ZFLOP will be 
enabled, and which video mode will be visible on 
the screen 

Check your wiring and restore the computer to 
its case. Power up, and command OUT 254,2. 
The screen will reverse. The effect, alas, will not 
be as dramatic as you might expect because the 
video monitor is not a great piece of work. 

Power down the system, unplug the monitor, 
and open it up. You might find that a hex-nut 
driver is necessary to open the monitor intead of 
a Phillips type; later monitors used 1/4-inch hex 
nuts. 

When it is open, find the plug-in circuit card 
closest to the monitor wall (some have only one), 
and locate the resistor marked R14. The present 
value should be 3.3K ohms (orange, orange, red, 
silver or gold). We want to give the video signal 
a bit more 'oomph', so piggyback the 1.5K ohm 
resistor atop R14 and solder it in place. Restore 
the cabinet. The reverse video modification is 
complete. 






Clumsy? Me Too. Do This First. 

During the course of these modifications, 
there will be connections made to integrated 
circuits which are carrying piggies atop their 
back. In case your soldering iron is a bit obese, 
you might want to solder wires to these circuits 
in advance. 

All these pins will have wires running to 
them: 

Z22, pin 3 

+Z25, pins 11, 12 and 13 

+Z27, pins 4 and 5 

Z30, pins 1 and 13 

Z41, pin 6 

Z52, pin 6 

Z54, pin 8 

Z59, pin 5 

Z60, pins 4 and 5 

Z63, pin 12 

Only those marked with a plus sign ( + ) 
actually carry piggies, but since everything is 
close together, you might want to make all the 
connections in advance anyway; so there they 
are. 



Photo 4-9. Two photos (a) & (b) of two keyboards. 
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Lower Case with Upper 

Many modifications have been proposed to 
obtain lower case characters already present in 
the TRS-80 character generator. Some are 
incompatible with each other, although they do 
provide access to a group of special control 
characters also burned into the character 
generator. 

The modification provided here is simple, 
compatible with both the Radio Shack and 
Electric Pencil modifications, and should give no 
grief throughout its life. For this modification 
you will need a single integrated circuit, and 2102 
AN-4L memory chip. These chips are available 
from several suppliers; in a pinch, the 21L02 sold 
by Radio Shack will do the job. 

The 2102 will be piggybacked - except for pins 

11 and 12 - atop Z45, also a video memory chip (it 
will not necessarily be marked a 2102, since 
Radio Shack ordered house numbered parts for a 
while, but it is a 2102). Bend pins 11 and 12 of the 
piggyback 2102 parallel with its body, and fit the 
integrated circuit on Z45, making sure it is 
positioned in the correct direction. Solder 
extremely carefully, pin for pin, down one side 
(pins 1 to 8), and up the other (pins 9 to 10, 13 to 
16). 

Now locate Z25. It is an integrated circuit 
containing four OR-gates, one of which is not 
used. With solder-wick, suck up the extraneous 
solder that is present on pins 11, 12, and 13, and 
with a sharp X-acto knife or razor blade, cut pins 

12 and 13 free from each other and from the 
ground lead going to pin 7. 

Now locate the trace on the circuit board 
running from Z60 pin 4 to Z30 pin 13. Use an 
ohmmeter if necessary to make sure you have the 
correct trace. Cut it through. Double check that 
you have not cut the trace that runs from Z60 pin 
4 to Z27 pin 13. 
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Finally, run four wires: from Z60 pin 4 to 
piggy-Z45 (call it ZMEM from now on); from 
Z60 phi 5 to Z25 pin 13; from Z30 pin 13 to Z25 
pin 12; and from Z25 pin 11 to ZMEM pin 11. 

The lowercase modification is complete. A 
memory chip to represent the missing bit 6 has 
been added, and the necessary triggering 
information (bit 7 and bit 5) has been gated 
through Z25. Why is it necessary to gate bits 7 
and 5 to trigger ZMEM? Because the 
information sent by Radio Shack's print routine 
does not include bit 6; in an unmodified 
machine the bit is generated by the presence of 
bit 7 and bit 5! Check the Technical Reference 
Handbook for details. In this case, the false bit 6 
is generated where necessary by Z30, and ORed 
with a true bit 6. In other words, either case will 
result in bit 6 being embedded in the new bit 6 
video RAM, ZMEM. 

Note: Several TRS-80's in which I have 
installed this modification contained a Z25 
with the spare gate dead. Perhaps it was a 
Radio Shack economy move. If so, piggyback 
a 74LS32 on Z25, soldering pins 7 and 14 to 
Z25, and continue with the remaining 
lowercase mod instructions. 

The lowercase modification can be tested as 
follows; a complete lowercase driver is presented 
in Chapter 3: 



10 CLS 

20 FOR X = 15360 TO 15360+255 

30 POKE X,Y 

40 Y=Y+1 

50 NEXT 

60 GOTO 60 



Figure 4-9. Upper/lowercase schematic. 



One by One 



Reversing individual characters is similar to 
the process of reversing the entire video screen, 
except that the reversal is carried out only for a 
short period of time. That period is determined, 
of course, by the letters being displayed. (At 
this point, I should note that all four internal 
hardware modifications in this chapter are 
partly interrelated. Both reverse video and 
high-speed modifications use the same output 
port decoding; both reverse video and reverse 

characters use the same flip-flop; both reverse 
characters and upper/lower case use the same 
video memory decoding hardware). 

Before installing the individual-character 
reverse video, the upper/lower case modification 
must be installed. This will provide the 
essential bits 6 and 7 (see that section for an 



106 



explanation of the 'phantom' bit 6). For the 
individual character reverse, three additional 
integrated circuits will be needed: one 74LS86 
Exclusive-OR gate, one 74LS10 triple-input 
NAND gate, and one 74C04 hex inverter. The 
last is very important, because it is used for 
aligning the reversal pattern with the letter to be 
reversed. You will also need a small variable 
resistor (trimmer potentiometer, or 'trimpot'), 
approximately 50,000 to 100,000 ohms; two 
capacitors, one 330 picofarads (pF) and one 
0.033 microfarads (mF). 

As before, bend all pins of the 74LS86 except 
pins 7 and 14 parallel with the body of the 
integrated circuit. Affix the 74L386 atop Z24, 
and solder power pins 7 and 14 to it. This gate 
will multiplex the combined bit 6/7 signal with 
the output of ZFLOP (from the previous 
complete reverse video modification). Call this 
gate ZMUXX. 

Remove the wires attached to the outputs 
(pins 8 and 9) of ZFLOP, and run them, 



Carpentry Considerations 



respectively, to pins 2 and 5 of ZMUXX. Now 
run a pair of wires from pins 6 and 3 of ZMUXX 
to pins 15 and 1 of ZMODE (which were just 
disconnected from ZFLOP). In other words, 
ZMUXX has been inserted between ZFLOP and 
ZMODE. 

Next position the 74LS10 correctly atop Z25 
and solder the power pins in place. Call this 
circuit ZBITS, because it will evaluate which bits 
of given letters should cause the reversal to take 
place. 

The steps below summarize all the activities to 
complete this modification; some have been done 
already, (such as the lowercase modifications) 
but are included for clarity: 

1. Break trace from Z30, pin 13 to Z60, pin 
4. 

2. Break trace from Z63, pin 12 to Z42, pin 13. 

3. Break trace from Z42, pin 12 to Z27, pin 4. 

4. Cut loose Z25 pins 11, 12, 13, from pin 7. 



Carpentry Considerations 

When you first open your TRS case, you'll 
probably be unfamiliar with what comes out. 
The photo below is presented to remind you 
that six screws and five white spacers make up 
that group: 
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Photo 4-12. Screws and spacers in keyboard unit 

When you have been soldering in and around 
the circuit board, chances are that a lot of ugly, 
crusty brown flux residue will build up. In 
order to see what you are doing and make sure 
connections are sound, you should clean this 
mess. There are flux removal compounds 
available, and these should be applied with 
cotton swabs. 



My own choice is a gentle but very fast acting 
substance which can sometimes be found in 
surplus - Thermo-Fax brand belt cleaner. This 
treats the boards and their coating without 
harsh chemical action, but removes the flux 
within seconds. 

Another area of difficulty in doing these 
modifications is cutting traces. Place the circuit 
board on a very secure and stable table, 
cushioned just a little with a towel. Lean firmly 
but gently on the board, and move an X-acto 
knife or single-edged razor blade back and forth 
until the trace gives way. This may take as 
many as 20 or 30 scrapings. 

When the trace looks cut, make sure. Cut 
deep into the fiberglass base so you can see a 
cut space, and then wipe the area clean with 
flux or tuner cleaner so the break is obvious. 

If you must resolder a trace, scrape the green 
masking from both sides of the cut, wipe it 
clean, and flow solder on both sides, but don't 
bridge the trace with solder. Instead, take a 
piece of bus wire or stripped wire-wrap wire, 
form it into an 'L' shape, and solder the base of 
the L across the trace. Then cut off the excess. 
Bridging with solder alone is dangerous because 
it can look fine, but really be attached only by a 
glob of flux, or be attached so weakly that 
flexing the board will crack the solder off. 
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5. Piggyback on Z45 a 2102, soldering pins 1, 2, 
3, 

4, 5, 6, 7, 8, 9, 10, 13, 14, 15 and 16. 

6. Piggyback on Z24 a 74LS86. 

7. Piggyback on Z25 a 74LS10. 

8. Piggyback on Z6 a 74C04. 

9. Run a wire from Z60, pin 5 to Z25, pin 13. 

10. Run a wire from Z30, pin 13 to Z25, pin 12. 

11. Run a wire from Z25, pin 11 to Z45piggy, 
pin 11. 

12. Run a wire from Z45piggy, pin 12 to Z60, 
pin 4. 

13. Run a wire from Z45piggy, pin 12 to 
Z25piggy, pin 1. 

14. Run a wire from Z63, pin 12 to Z25piggy, 
pin 13. 

15. Run a wire from Z25piggy, pin 2 to Z27, pin 
5. 

16. Run a wire from Z25, pin 12, to Z6piggy, 
pin 1. 

17. Connect together Z6piggy, pins 2 and 3. 

18. Attach one terminal of the 100,000-ohm 
trimpot to 

Z6piggy, pin 4. 

19. Attach the other terminal of the 
100,000-ohm 

trimpot to Z6piggy, pin 5. 

20. Attach one end of the 330-pf capacitor to 
Z6piggy, pin 5. 

21. Connect together Z6piggy, pins 6 and 13. 

22. Attach the other end of the 330-pf 
capacitor to 

Z6piggy, pin 12. 

23. Attach one end of the 0.033-mf capacitor to 
Z6piggy, pin 12. 

24. Attach the other end of the 0.033-mf 
capacitor 

to Z6piggy, pin 11. 

25. Connect together Z6piggy, pins 9 and 10. 

26. Run a wire from Z6piggy, pin 8 to Z24piggy, 
pin 1. 

27. Connect together Z24piggy pins 1 and 4. 

28. Run a wire from Z63, pin 12 to Z25piggy, 
pin 3. 

29. Run a wire from Z42, pin 12 to Z25piggy, 
pin 4. 

30. Connect together Z25piggy, pins 5 and 14. 

31. Run a wire from Z25piggy, pin 6 to Z27, pin 
4. 

32. Disconnect the wires running from ZFLOP 
pins 8 

and 9 to ZMODE. 

33. Run the wire from ZFLOP, pin 8, to 
Z24piggy, pin 2. 



34. Run the wire from ZFLOP, pin 9, to 

Z24piggy, pin 5. 

35. Run a wire from Z24piggy, pin 3 to 
ZMODE, pin 1. 

36. Run a wire from Z24piggy, pin 6 to 
ZMODE, pin 15. 



The modification is complete. Using the 
individual reverse video is not the easiest 
process, but works nonetheless. Printing 
CHR$(0) through CHR$(31) results in control 
codes being acted upon; CHR$(32) through 
CHR$(127) now produce the full range of ASCII 
letters; CHR$(128) through CHR$(191) produce 
graphics characters; and CHR$(192) through 
CHR$(255) produce the 63 possible TAB 
positions. 



To use the individual character reverse, then, 
you cannot PRINT the CHR$ value. Instead, 
you must POKE the value onto the screen. 
Granted, this is a pain, but when a program is 
completed, the prompting can be extraordinarily 
effective. Besides, it's not that hard. Try this: 



10 CLS : Y=15360 
20 FOR X = TO 255 
30 POKE Y,X 
40 Y=Y+1 
50 NEXT X 
60 GOTO 60 

Listing 4-1. Individual character test program. 

Chances are that a group of reversed 
characters appeared, but the reversal band 
didn't match up with the actual characters. 
That's the reason for the 74C04 and the 
100,000-ohm potentiometer. Run the following 
test program: 



10 CLS 

20 FOR X = 16040 TO 1E060 

30 POKE X,255 

40 NEXT 

50 GOTO 50 

Listing 4-2. Individual character alignment program. 

Now adjust the potentiometer until the 
crosshatches are centered precisely within the 
white band (or rather, so the white band is in the 
correct background position). 
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HI JUIlKPSnf.y.-Ct.- .. • *ca?r*,. i in#*st»M*dz< : P 



Complete font of reversed characters. Because only 64 characters 
remained in the available set, upper and lower case were chosen 
as opposed to numbers and symbols. 



That is a simple example of the individual 
character-reverse process, using BASIC. By 
using ordinary displa routines in machine 
language programs, the individual character 
reverse is an entirely trivial matter, but really 
putting it to work in BASIC requires a bit of 
fancier footwork. 

Using it through BASIC can be done without 
POKEing large numbers of characters in 
prearranged locations. Instead, the position of 
the cursor on the screen can be determined, and 
the characters POKEd in place from there. The 
subroutine below is useful: 

10000 X = PEEKI16416) + 256»PEEKI16417) : RETURN 

This subroutine determines the position of the 
cursor and assigns it to X. Then characters may 
be POKEd as follows: 



40 GOSUB 10000 

50 AJ = "THESE ARE REVERSE LETTERS" 

60 FOR N = 1 TO 25 

70 = ASC (MID$ IAS,N,D] 

80 POKE X,Q 

90 NEXT 

100 GOSUB 20000 



Listing 4-3. Individual reverse demo program. 

The GOSUB 20000 executes the following 
one-line subroutine: 

20000 ZH - FIX (X/256) : ZL = X-ZH*256 : 

POKE 16416, ZL : POKE 16417, ZH : RETURN 



This short routine restores the cursor position 
after the POKEs have taken place. There are two 
very important things to note: 

1. If the POKE is to take place on the last 
line of the screen, make absolutely certain 
that the value of X does not exceed 16383, 
because this will POKE nasty values into 
BASIC vectors beginning at 16384. A test 
for X greater than 16383 can be made so: 



10005 IF X>16383 THEN X=963B3 
: PRINT : RETURN 



GOSUB 20000 



This will have the effect of restoring the 
cursor, printing a carriage return, and 
finishing the text to be printed. 

2. The POKE feature does not include a 
carriage return, so this method of printing a 
reversed message has the effect of a PRINT; 
(PRINT semicolon) statement. Immediately 
follow the return-from-subroutine with a 
PRINT statement if the rest of the message 
is to be printed on the next line. 

A few peculiarities may arise with this 
modification; among them: 

1. The 'fill' character of Electric Pencil may 
change. This is because any program 
defining graphics characters as 192 to 255 
instead of 128 to 191 is not using them 
according to the original Radio Shack 
specifications. 

2. Single reversed letters scattered 
throughout text may not work. This is due 
to the extremely fast requirements of the 
circuit, and the fact that certain integrated 
circuits may not be up to it. Two characters 
together, however, will print properly. 

3. The timing is so crucial that temperature 
may offset the image slightly. Use 
polystyrene or polycarbonate capacitors, 
never ceramic disc capacitors, for this 
modification. 

4. With a screen full of reversed letters, 
some increase of the brightness control may 
be needed. 

5. The full character set is not available 
because more hardware would be necessary 
to obtain the logic information necessary to 
select out, for example, letters and numbers 
or letters and symbols. 

Although it sounds like I am doing a lot of 
warning about the limitations of this sort of 
modification, you should realize that the TRS-80 
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Photo 4-13. Individual reverse screen example. 

Reverse lettering provides an emphasis; flashing from one to the 

other is extremely effective for prompts. 

was never meant to do this sort of thing, and the 
fact that it does work is remarkable. Once it is in 
place, you will wonder how you could have 
created reasonable self-prompting programs 
without it. See Photo 4-13 for proof of the 
impressive results. 

A complete circuit containing the reverse 
video, upper/lower case, and individual reverse 
video modifications appears in Figure 4-10 , 
below: 



Stepping on the Accelerator 

When you first unpacked your TRS-80 and 
tried a few calculations and displays, you were 
likely amazed at the speed with which the 
TRS-80 was able to respond. But certainly as you 
used the machine, you realized that it could 
spend quite a while performing complex tasks. It 
was then that you joined the ranks of the dozens 
of thousands of micro users searching for a faster 
running computer. 

When the TRS-80 was designed, the options 
for higher speed were put in place. Normal and 
200 percent speed options were right there on the 
circuit board, and 150 percent speed required the 
routing of but a single circuit trace; yet the final 
design opted for the lowest speed (1.77 MHz). 

This modification releases the permanent 
connection of the 100 percent (1.77 MHz) clock 
and allows the computer to switch back and forth 
between this clock rate and a rate 
one-and-one-half times faster - 2.66 MHz - or 
two times faster - 3.55 MHz. There are a few 
pitfalls, but the actual modification is a simple 
one. For it, you will need the decoded port 254 
explained in the reverse video section of this 
chapter (74LS02), the other half of the flip-flop 
(74LS74), and one 74LS367. 
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Figure 4-10. Complete video modifications schematic. 
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Stepping on the Accelerator 



Before you perform this modification, there 
are a few things you should know. For a reason 
which I have yet to determine, some Level II 
machines with the two-chip ROM set will not 
accept a speed-up successfully, though most 
will. Second, later units have been 
manufactured (or earlier units may have been 
retrofitted) with a small board known as 'XRX 
EH', a synchronous, 500-baud wave shaper. 
Cassette load at the 750- and 1000-baud rates 
will not work unless the modification is 
deactivated (for details on the cassette system, 
see the Supplements to Chapters 3 and 6). 

The third item concerns the expansion 
interfaces manufactured since Ja ;uary 1980. 
Unfortunately, these interfaces must also be 
modified to accept a higher-speed CPU. But this 
modification (see Chapter 5) is quite simple and 
very reliable. Finally there is the question of 
memory speed. If your TRS-80 is very early and 
the 16K RAMs were shipped with the unit, there 
is a small chance that one or more of these RAMs 
will not be capable of running at 3.54 MHz --and 
an even smaller chance of not operating at 2.66 
MHz. 

That said, I'll turn to the modification itself. 
Locate Z56 on the circuit board. Cut the foil 
trace that leads from this pin to the hole that is 
plated through the circuit board. Mark that hole 
for future reference. By cutting this trace, you 
separate the 1.77 MHz output of Z56 from the 
clock input of the Z80 processor. 

If you have not created the port 254 decoding 
used in the reverse video modification, you will 
need to piggyback a 74LS02 on Z53. Bend all the 
leads except 7 and 14 parallel with the body of 
the IC, and seat it atop Z53 with the notch or dot 
pointing in the same direction as the rest of the 
integrated circuits on the board. Solder pins 7 
and 14 to Z53; this piggybacked circuit will be 
called ZPORT. 

Locate Z52; run and solder a wire from pin 6 to 
pins 2 and 3 of ZPORT. Find Z54. Run and 
solder a wire from pin 8 of Z54 to pin 11 of 
ZPORT. Pins 1 and 12 of ZPORT are connected 
together. This completes the decoding of port 
254 (hex FE). To add the necessary OUT signal, 
run a wire from Z22 pin 3 to ZPORT pin 5. Solder 
together pins 8, 9, and 13 of ZPORT; solder 
together pins 6 and 10 of ZPORT. The BASIC 
command OUT 254.X will activate the signal 
found at ZPORT pin 4. 

Also a part of the reverse video modification 
was the piggybacking of a 74LS74 atop Z26. 
Bend all leads parallel to the body of the IC 



except power pins 7 and 14. With the integrated 
circuit oriented in the same direction as Z26, 
mount it there, soldering pins 7 and 14 to the IC 
below. This IC is called ZFLOP. 

Run a wire from the decoded signal at pin 4 of 
ZPORT to pin 3 of ZFLOP. Z59 has a data line 
(bit 0) at its pin 4; run a wire from that pin to pin 
2 of ZFLOP. Now run wires connecting together 
pins 1, 4 and 14 of ZFLOP. With these 
connections made, OUT 254,0 will flip the 
circuit, and out 254,1 will flop it. Note that OUT 
254,0 and OUT 254,2 were the flip-flop 
commands for the reverse video. 

Now the 74LS367 is put in place. As with the 
other ICs, bend all leads except the power pins 
(pins 8 and 16 on this circuit) parallel with the 
body. Place the 74LS367 on Z44, and solder pins 
8 and 16 to it. Call this ZFAST. 

Locate pin 8 of Z56, whose trace is already cut. 
Run and solder a wire from this pin to pin 2 of 
ZFAST. Run a wire from pin 3 of ZFAST to the 
plated-through hole, which was previously 
marked for reference. Take care that this is the 
correct hole before soldering; it is the other end of 
the trace cut from Z56. 

The normal clock will now be reunited with the 
CPU. Run a wire from pin 5 of ZFLOP to pin 1 of 
ZFAST and solder. When OUT 254,1 is 
executed, the normal speed will flip in place. The 
other speed output buffer is wired now. Tie pins 
13 and 3 of ZFAST together. Last, run a wire 
from pin 6 of ZFLOP to the second gated section 
of ZFAST, pin 15. 

The higher speed will now be selected. The 
options are two, and you may try either 150 
percent normal speed or a hot 200 percent 
normal speed. 

150 percent normal speed: Locate Z43, pin 2, 
which is the 5.32 MHz clock normally used in 
the video divider chain. Run a wire from this pin 
2 to Z56 pin 14. That pin is the input of an 
unused divide-by-two segment of Z56. The 
output (2.66 MHz) of this divider is present at 
Z56 pin 12. Run a wire from there to pin 14 of 
ZFAST. 

200 percent normal speed: Locate Z56, pin 11. 
This is the 3.54 MHz clock not used in the TRS- 
80. Run a wire from this pin 14 of ZFAST. For 
this super-fast mod, the memory select circuits 
must also be dealt with. Locate Z69, and cut the 
trace running from pin 5 to pin 12. Connect pin 
12 to pin 13. This speeds the memory-select 
process (from MREQ and RD) just a tad, but 
enough to cope with the 200 percent 
modification. 
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Figure 4-11. High-speed circuit diagram. 



<d ' Z56 



The high speed modifications are now 
complete. Reassemble the TRS-80 and run a test 
by trying OUT 254,0 and OUT 254,1, which will 
flip and flop the speeds. The following short 
BASIC program will give a good demonstration 
of the speed differences: 



10 FOR B = TO 1 

£0 CLS 

30 OUT 854, B 

40 FOR X = 1 TO 50 

50 PRINT X; 

60 NEXT : NEXT 

70 GOTO 10 



Listing 4-4. High-speed demo/test program. 

In addition to the modifications themselves, it 
is often useful to know which speed is active. 
There are ways of telling after working with the 
higher speeds: the very slight herringbone in the 
video monitor (turn contrast high to see it) 
changes pattern, programs work faster, etc. 
However, a bipolar LED is ideal for this. 

To pin 1 of ZFAST, attach one end of a bipolar 
LED. Attach the other pin to a 470-ohm 
resistor, and run this resistor to pin 15 of 
ZFAST. The light will show green for one speed 
and red for the other; by reversing the center pin 
of the LED, the color pattern selected can be 
reversed. I use red for the normal speed, and 
green for the higher speed. 
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Figure 4-12. LED hig-speed indicator circuit diagram 



Level I and Level II Together 

Little defense of Level I BASIC has been 

made, but from my point of view, it's a delightful, 
compact little BASIC. My own familiarity with it 
is relatively recent, because^! ordered my TRS-80 
with Level II installed. Aside from the 
maddening lack of key rollover, Level I seems an 
ideal teaching language, especially for 
youngsters. Together with the excellent Level I 
manual created by David Lien, it is a fine 
introduction to the language, and to computers 
themselves. 

Enough for the defense. The problem with 
Level I is that it is not Level II, and the bulk of we 
TRS users have Level II BASIC installed. Level 

I can nonetheless be co-resident, and there are 
three ways to do it: install the Level I ROM with 
a switch (this is the method presented here); use 
a disk system with the Level I-in-Level II 
program (offered by Apparat and others); or 
relocate and rewrite Level I a bit and burn it into 
an EPROM placed in high memory. 

Level I ROMs are getting harder to obtain 
because of the Model I's discontinuance, but 
cooperative repair centers or franchise Radio 
Shacks ('Associate Stores', Tandy calls them) 
can often provide the ROM for a few dollars. 
Although I am not one to encourage software 
copying, I do feel that as a TRS-80 purchaser, 
you paid for your Level I ROM if you bought the 
unit with one. If it was not returned when Level 

II was installed, then Radio Shack owes you one. 
Try to get it. 

The other way is to order the ROM as a 
replacement part; Radio Shack's latest 
replacement number is MX4126, and they 
charge $71.25 (!) for it. Finally, you can borrow 
one from someone who has it and copy it into a 
2732 EPROM, but that's still about a $40 
investment. 
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Let's assume you're able to obtain a Level I 
ROM. The ones you want are marked National, 
and are identified with parts numbers 
M2316E/MMS258ET R/N and S/N, or 
Motorola, marked 7807 and 7804 or 7831- 
BASIC1-ROM A and 7832-BASICl-ROM B. 
Ideal is the single-chip ROM from Motorola or 
Rockwell, marked 7809 and 7845, respectively 
(phew!). Photo 4-(?) shows the two-chip 
(7831/32) set and the Rockwell (7845), mounted 
on an aluminum-foil-covered vegetable tray. 

You do not want the chips marked Intel; these 
are 2716 EPROMs, and the wiring is complex. 
About the only thing they are good for is scraping 
off the label and erasing under ultraviolet light. 
Then you have two spanking new $12 EPROMs. 

Check next to see if you have the two- or 
three-chip Level II ROM set. If you have the 
three-chip set, there will be a connector cable 
running to a separate board taped to the main 
circuit card. If not, both ROM sockets will be 
filled, and installing Level I will be more difficult. 
Last of all, make sure your circuit board is a 'D' 
board, 'G' board or later. 'A' boards won't do. 
(The number is part of the lettering silkscreened 
on the board, such as 1700069D or 1700069G). 

First will be instructions for installing the 
ROM in the TRS-80's with outboard Level II 
ROMs. Mount a double-pole, double-throw 
switch conveniently, but discreetly enough that 
you won't be knocking it into Level I in the 
middle of a four-hour data sort. 




Level II ROMs: 3- chip set on individual board at the end of a 
cable which is plugged into the main CPU card. 



Open up the TRS-80, and note where the Level 
II ROM cable is plugged. Four (or six) other 
wires run from this Level II board to the rest of 
the circuit card. Find these locations: 

1. The green wire on the Level II board, 
connected near the underside of dip shunt X3. 

2. ROM socket Z33 or Z34 (whichever is 
empty), pins 18 and 20. 

Cut the traces leading from pins 18 and 20 of 
the unused ROM socket. Add a short length of 
wire between pin 20 and the far end of the trace 
that used to lead from pin 18. Solder a long white 
wire to pin 18. Remove the far end of the Level II 
board's green wire from its connection point near 
shunt X3, and solder a red wire there. Solder a 
blue wire to the 5-volt supply found at Z57, pin 
14. Using Figure 4-13, run the white, green, red 
and blue wires to the double-pole, double-throw 
switch. 

Add two 1000-ohm resistors to the circuit to 
hold the ROM chips inactive when they are not in 
use. Without them, inadverent selection might 
take place, and the running program (in either 
language) might crash. 

If you've got the single-chip Level I ROM, 
you're all set to go. If not, the fun begins here. 
Locate the notch on each Level I ROM chip, and 
line up the two chips with each other, precisely 
pin for pin. Now piggyback one atop the other 
and solder all 24 pins so that the result is a 
single, hulking, integrated circuit. Solder 
carefully, keeping the bottom IC anchored in 
conductive foil. The foil will act as a static 
remover and heat sink, both essential in this 
mod. 

Blobs of solder can be removed with some sort 
of solder-wick or a solder-removing vacuum tool. 
This entire chip is then inserted in the empty 
socket, and the unit is ready for testing. Level II 
gives you the expected MEMORY SIZE?, while 
Level I only reports 'READY'. 

If you have the two-chip Level II ROM set, 
there's a bit more work to do. One ROM must 
be removed and piggybacked on the other, 
except for pin 20. Bend pin 20 out straight on 
ROM A (Z33), and piggyback it on ROM B 
(Z34). Run a wire from ROM A pin 20 to Z74 pin 
9. Bend pin 20 out straight on ROM B (Z34), 
and run a wire from this pin to Z74 pin 12. Now 
insert your Level I ROMs in the socket for Z33. 
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Figure 4-13. Level I and II switch wiring (3-chip set). 
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Since these languages use memory and 
pointers in such a different manner (Level I is not 
by Microsoft, as I understand it), they cannot be 
switched from one to the other directly. You 
must power up to the language you want. 

This can present a problem. If you have 
installed various speed and video modifications, 
you may get the mode you don't want. Level I, 
lacking OUT statements, can't recover from this. 
To avoid it, solder a wire to Z53, pin 12, and 
attach it to one end of a pushbutton; to the other 
end of the button, solder a wire to ground (Z53 
pin 7 is fine for that). This is the system reset 
(SYSRES) signal, a true restart to 0000. 

To use it, power up to Level II, get in the 
video/speed mode you wish using OUT 
statements, switch to Level I (the screen will 
likely display a mess of @9@9@9's), and press 
the SYSRES button. A READY should appear. 
Now dig back in the Level I manual to determine 
if the amount of memory reads correctly. 



Figure 4-14. Level I and II switch wiring (2-chip set). 




Two-chip Level I ROM set can be added by piggybacking them 
and soldering them together. Together with the snaking Level II 
cable, they form a surrealistic electronic landscape. 
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On Relocatable Code 

A great noise is often made by programmers 
and users of the TRS-80. The clamor is for an 
elusive programming quality which allows code 
to be placed anywhere in memory and to function 
from that place. The cry is for relocatable code, 
but it is often called for without understanding 
either the process or the sacrifices it requires. In 
this section I will take a look at the various levels 
of relocatability, and the ways it can be applied in 
low-level languages. 

The most 'relocatable' code TRS-80 users see 
is BASIC itself. No matter what configuration 
changes the system undergoes, whether they be 
the use of low-memory utilities, DOS, etc., a 
normal BASIC program will load and run. A 
BASIC program's portability depends on the 
premise that it is interpreted, containing 
statements that are equally meaningful 
irrespective of the program's position in memory. 
Occasionally that position gains importance, - as 
when numerical variables, strings or arrays are 
referenced within program lines, but normally 
those positions do not become significant until 
the program is in operation. 

Unless the BASIC program is truly a hybrid 
(having other, lower-level languages artificially 
embedded in the code), it is eminently portable. 
All references are resolved by its interpreter, and 
relocatability of BASIC is assumed in the very 
nature of it and similar high-level, interpreted 
languages. In fact, that is the nature of a real 
'language' as we know it as opposed to the 
mysteries of 'code'. 

The distinction between language and code is 
not an accepted one, and the differences will be 
characterized only for descriptive clarity within 
the context of this article. By 'language', I intend 
BASIC, FORTRAN, Pascal, and others, as well 
as assembly language. By 'code', I suggest 
machine code as written in binary or 
hexadecimal for direct insertion in memory. The 
assembly language/machine code interface is 
curious and I will address it in terms of the 
conflict between understanding and using a 
language as opposed to a code. 

At the High Level 

The highest levels of languages are the 
so-called 'descriptive' languages, like IBM's 
report-generator, RPG II. A programmer need 
only describe a group of tasks and the order in 
which they should be performed, and they will be 
magically executed. Full-dress accounting 



reports, billings, and record-keeping can be done 
with a language like RPG II. Relocatability is at 
best the task of a dour 'systems engineer'. 

Likewise, BASIC normally requires no 
thought to its arrangement beyond the proper 
sequence of line numbers. Statements are 
arranged in the programmer's chosen order, and 
the interpreter selects each one for execution in 
that order. Line numbers are the programmer's 
relocatable reference. Languages containing no 
line numbers often use an implicit 'top-down' 
order; that is, once a task is completed, it is never 
returned to. Still, the program is created with an 
arbitrary arrangement selected by the 
programmer and evaluated by an interpreter 
before its execution. 

Languages which use compilers rather than 
interpreters work in much the same manner. 
Whereas an interpreter selects and executes each 
command and operand during the program's run, 
a compiler produces a block of machine-coded 
information from high-level commands and 
operands. The process is completed before 
executing the program, so valuable space and 
running time can be saved. In either case, 
arbitrary, high-level language can be moved 
about, deleted, inserted, or otherwise altered 
with little regard for the program's ultimate 
position within the bowels of the computer. 

In fact, the question of relocatability is implicit 
in the term 'high-level language', and is an 
essential of its high-level quality. 

The reason the question arises at all is because, 
when writing machine-coded utilities, many 
programmers feel that emulating the portability 
of a high-level language is crucial. It becomes 
even more desirable when programming is done 
for a user rather than another programmer, a 
user whose contact with the machine may go 
little further than that of a traditional computer 
'operator'. 

Accomplishing relocation can be an easier task 
on the Model I than on other computers simply 
because of the extensive ROM-based operating 
system. Before examining some ROM uses (and 
its advantages and pitfalls), let's have a look at 
the qualities and constraints of relocatable 
machine code. 

As a user interested in accomplishing a task, I 
might need to select from a group of utilities 
including sort routines, multiple-precision 
transcendental functions, mundane 
key-debounce and upper/lower case drivers, and 
so forth. Ideally, the order in which I select and 
load these routines should be irrelevant to their 
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operation, in much the same way that utilities 
can be 'ordered up' on a mainframe. 

Microcomputer software authors have not 
generally respected this need; in some measure 
that is forgivable because the approach and 
intent of different utilities from a variety of 
vendors demonstrates that relocatability is only 
one of many potential conflicts to be resolved. 

Hunting Through Memory 

Nearly any well-written program is tailored to 
meet certain requirements which may not easily 
co-exist. Among them are: 

Speed of execution. This applies in two 
ways. The first is the speed at which the 
need for the utility is evaluated - an 
example might be a routine scanning a 
keyboard for a unique combination of 
characters. This should be accomplished 
expeditiously, since no real program 'work' 
is being done. The second speed 
consideration is that, once called for, the 
main routine should complete its work 
handily. 

Conservation of memory. In a system of 
unlimited size, speed can be optimized by 
replication of routines rather than use of 
subroutines. In appliance-level 
microcomputers like the TRS, however, 
support utilities cannot be allowed to 
consume memory space needed by the 
operation of the target program. 

Resolution of Conflicts. 

All operating systems make use of areas of 
critical reserved RAM, which are employed 
to tie together the major pieces of hardware 
and blocks of software. These patch points 
(I prefer this term to 'vector', which also 
means a disease-carrying insect) may be 
needed by many other utilities as well as 
the operating system, and must be 
redirected carefully. 

ROMability. The traditional approach 
states that programs must be created so 
that they can be committed to ROM at any 
time. That is, they should neither modify 
themselves nor contain variable data 
within their bounds. This approach can 
certainly be argued against (I shall). 

Three of these four elements - speed, size, and 
memory sharing - are normally considered in 
utility programming, and become critical in 
relocatable programs. 



In addition, factors to be considered 
exclusively for program relocation are: 

The placement of the program in 
memory. This can be a single- or multiple- 
step process. For example, during loading 
from disk or tape, a program may 
temporarily reside in a single block of 
memory, only to separate itself into smaller 
blocks which are shepherded to other 
memory fields. Electric Pencil is one such 
program. 

Absolute jumps within a program. The 

program counter is instructed to take on a 
new value, a value specified as an address. 
Thesejumps are, when taken, faster than 
the relative branches, because the program 
counter need not calculate an offset to its 

current address. 

(indent absorber) Subroutine calls within 
a program. Effective use of memory space 
makes subroutines very attractive, but 
they require that the program counter be 
assigned a specific new value for their 
duration. 

A relocation block. If the program is 
provided to a user in object-code 
(SYSTEM) format, some portion of the 
program must be dedicated to relocating 
itself in another area of memory. 

Assembly Programming 

When programming for programmers, the 
most convenient way to effect relocatable code is 
to use assembly language, and supply that to the 
user. By labeling all jumps and calls, such a 
program becomes 'relocatable', somewhat in the 
sense that a program conceived in a high-level 
language is relocatable. In fact, in its assembly 
phase, machine coding is a high-level language. 





8000 


21003C 


aooo 


11003C 


8003 


01FF03 


8006 


3620 


8009 


EDBO 


BOOB 


21 E942 


B00D 


7E 


B010 


A7 


8011 


C29719 


8012 


C30043 


8015 




4300 


CDB84B 


4300 


23 


4303 


Listing 4-5. Machine cc 



DBG 


8000 


LD 


HL.3CDDH 


LD 


DE.3CD1H 


LD 


BC.3FFH 


LD 


[HL),20H 


LDIR 




LD 


HL.42E9H 


LU 


A,(HL) 


AND 


A 


JP 


NZ.1997H 


JP 


4300H 


ORG 


4300H 


CALL 


438BH 


INC 


HL 



Above is a section of assembly programming. 
It makes several assumptions, some valid and 
some not. Let's consider that this program has 
cleared the screen (which it would in the TRS-80 
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configuration) after having performed some 
operations on a BASIC program. It checks 
location 42E9, the start of BASIC, for a zero. If it 
does not find a zero, it assumes a syntax error. 
Otherwise, it moves to location 4300, where it 
immediately calls a subroutine at 4388. 

This is perfectly valid code, but here's a look at 
another way of creating it in this high level 
language: 



D4XA FIGURE 1 


-) 


SETUP 


E0U 


8000H 






VIDEO 


EQU 


3C00H 






SCREEN 


EQU 


03FFH 






BASIC 


EQU 


42E3H 






PROGRM 


EQU 


4300H 






SYNERR 


ECU 


1997H 






TESTER 


EQU 


43BBH 




8000 




ORG 


$ 


21 D03C 


8000 


SETUP 


LD 


HL, VIDEO 


11013C 


8003 




LD 


DE.VI0E0+1 


01FF03 


8006 




LD 


BC, SCREEN 


3620 


8009 




LD 


[HL),20H 


EDBQ 


BOOB 




LOIR 




21 E942 


B00D 




LD 


HL, BASIC 


7E 


B010 




LD 


A,[HL) 


A7 


8011 




AND 


A 


C29719 


8012 




JP 


NZ, SYNERR 


C30043 


801 5 




JP 


PROGRM 




4300 




ORG 


t 


CDB843 


4300 




CALL 


TESTER 


23 


4303 


PROGRM 


INC 


HL 



Listing 4-6. Machine coding in assembly language. 

This assembly program, using its high-level, 
interpretive capabilities, can be easily relocated 
by a programmer changing a few equates. But it 
is not relocatable because it does not meet the 
criteria outlined above - i.e., it contains a specific 
origin (or rather, two), absolute jumps, calls to 
subroutine, and has no visible relocation block. 
Fortunately the start of BASIC has been defined 
in the table of equates, for it too can be a variable 
element where low-memory alterations have 
been made. 

As a programmer's utility, this method is 
acceptable. As a public program, it is 
questionable. The solutions, however, are 
neither easy nor obvious. 

Relocation Blocks, Time, and Space 

The first option is to provide a relocation 
block. The amount of coding the programmer 
must perform is increased, but memory use is not 
affected because this relocation block can be 
deleted upon relocation. A relocation block is 
provided with Radio Shack's KBFIX, for 
example, and with other utilities. The sample 
above might have a relocation block which asks 
for a new base address in protected memory, 
protects that memory, adjusts its internal 
addresses, and automatically checks for the 
beginning of BASIC program storage and other 
patch points it may require. 



For very short utilities, the relocation block 
may be longer than the utility itself, because it 
demands a user prompt and input, minimum 
error checking, calculation of base address, and 
adjustment of patch points. Even using ROM 
routines (such as 28A7 to display a message, 1BB3 
to accept user input, 1E4A for numeric 
conversions), this process is lengthy. 

One of the most painful aspects of this 
relocation is the adjustment of internal 
addresses; absolute jumps, calls, and table 
locations are among the addresses requiring such 
changes. Then what of the questions of speed 
and conservation of memory? Programs that 
move themselves during the course of operation 
must carry the excess baggage of a lengthy 
self-relocation block or use a plethora of relative 
instructions which can cost time during program 
execution. 

Let's address these speed and space questions. 
Table I lists a number of the relative instructions 
in the Z-80 set, along with the bytes, machine 
cycles and time required for their execution. In 
contrast, Table II presents similar absolute Z-80 
instructions, their execution speeds, and the 
percentage of time and space they require as 
opposed to the relative instructions. 







TABLE I 




Z-80 INSTRUCTION 


BYTES 

3 


T-STATES 


TIME AT 1 .77 MHz 


LD r, [IX+cl] 


19 


10.7 dS 


LD (IX+d), r 


3 


19 


1D.7 dS 


LD (IX+a), n 


4 


19 


10.7 dS 


ADD A, (IX+d) 


3 


19 


10.7 dS 


INC I IX+d) 


3 


£3 


13.0 dS 


RLC (IX+a) 


4 


23 


13.0 uS 


BIT b,(IX+d) 


4 


20 


11.3 dS 


SET b,(IX+d) 


4 


23 


13.0 dS 


JR B* 


2 


12 


6.B dS 


0JNZ e 


2 


13 


7.3 dS 



When this instruction is conditional, and the 
condition is not met, it uses 7 T-states (3.9 uS). 

Note: 

V = registers A, B, C, D, E, H or L. 
'd' = displacement byte 00 to FF 
'n' = single-byte integer 00 to FF 
'b' = bit position to 7 
'e' = offset byte 00 to FF 







TABLE 


II 










Z-B0 INSTRUCTION 


BYTES 


T-STATES 


TIME AT 


* TIME 1. 


SPACE 




1 






1.77 


MHz 


VS. REL. 


INSTR. 


LD r, 1HL) 


7 




3.9 


uS 


37* 


33% 


LD (HL), r 


1 


7 




3.9 


uS 


371 


339 


LD (HL), n 


2 


10 




5.6 


uS 


53* 


BOX 


ADD A, (HL) 


1 


7 




3.9 


uS 


37", 


335, 


INC (HL) 


1 


11 




6.2 


ub 


469 


33';. 


RLC (HL) 


2 


1b 




a. 5 


uS 


669 


50% 


BIT b,(HL) 


I 


12 




6.8 


uS 


BOX 


BOX 


SET b,(HL) 


2 


15 




B.5 


US 


65i 


50* 


JP nn* 


3 


10 




BJS 


uS 


B3X 


150* 


JP NZ.nn 


3 


10 




5.6 


uS 


m 


150* 
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When this instruction is conditional, and the 
condition is not met, it still uses 10 T-states, 3 
more than the relative branch instruction. In 
programs where such a condition is generally not 
met, the JR e instruction will save both time and 
memory. 

Note: 

'nn' = two-byt.e interger 0000 to FFFF 

Relative instructions in many cases command 
considerably more time than absolute ones. 
How does this reflect on program speed? The 
design engineers for the 6809 chip reported in 
BYTE a survey of 6800 instruction class usage 
based on static analysis (i.e., with the program 
not running) of 25,000 lines of source code. 
Because of the considerable differences in chip 
architecture between the Z-80 and the 6800, 
especially in regard to the Z-80's multitude of 
registers, this information (see Table HI) is not 
directly applicable. Yet it is instructive, 
particularly in the percentage of subroutine calls 
and branches, instructions similar in the two 
microprocessors. 



TABLE III 






Use of 6800 Instruction Types 






Loads [movement from reyister to register, and 






from memory to e register] 


23 


4% 


Stores [movement from e register to memory] 


15 


3% 


Calls and returns [absolute addressing] 


13 


.0* 


Conditional branches [relative] 


11 


ax 


Unconditional brenches [reletive] and jumps 






(abso lute] 


6 


sx 


Others 


30 


B% 



[Adapted from BYTE, 4:1, January 1978, p. 26) 

A remarkable 30 percent of program space is 
dedicated to motion of the program counter. 
This might suggest that a program using absolute 
instructions would be 15 percent faster overall 
than one using relative branches and calls. Since 
relative calls and returns are complex, however 
(see below), the time savings might be even 
greater. Absolute jumps use more space than 
relative ones, so space savings, though 
significant, would not be as impressive. 

What are the practical implications of this 
speed differential? A 1,000-byte subroutine 
(long by microprocessor standards) with no 
internal loops might execute in four 
milliseconds, as opposed to five milliseconds for 
such a routine written exclusively with relative 
functions. On the average, it might be 200 bytes 
longer. This means 200 iterations per second as 
opposed to 250. For a complex mathematical 
function which iterates through a routine many 
times, it could mean the difference between a 
four-hour and a five-hour run. For a patch to a 



keyboard scan, it could mean adding only a few 
seconds to an hour's program time. And for 
routines involved in occasional string handling, 
printing, low-speed input/output, error 
reporting, or a host of other applications, the loss 
of time is insignificant. 

The application itself is the answer to the 
viability of relative coding. In time-sensitive 
applications (music-generation routines, for 
example), and where every byte of code is 
crucial, relative instructions can interfere with a 
program '8 effectiveness. In the bulk of TRS-80 
applications, which are seldom so time- 
conscious, relocatable coding through use of 
relative instructions can be very successful. 



Creating Relocatable Code 

The Relative Branch. The first coding choice 
is the two- byte instruction for changing the 
program counter. No matter where the program 
counter is currently pointing, it can be shifted by 
specifying a relative branch. When the high bit 
of the specified offset is zero, the program 
counter is moved ahead (for example, 18 37 adds 
37 to the program counter) . When the high bit of 
the offset is one, the program counter is moved 
back, in effect subtracting 80 before adding the 
offset: 



5236 
+ 00 



5236 
+ B0 



5236 51 B6 

(5236+0) [5236-100+80] 



5236 
+ 7F 



5236 
+ FF 



52B5 5235 

(5236+7F) (5236-100+FF) 



Especially gratifying is the notion that the 
page of the address (the high byte) is 
incremented or decremented automatically by 
this instruction: 



PC = 52C5 


[page 52) 


Execute 18 37 




PC - 52C7+37 = 52FE 


[page 52) 


Execute 18 37 




PC ■ 52FE+37 = 5335 


(page 53) 


Execute 18 A7 




PC = 5335+CA = 52FF 


(page 52) 



The branching can be done unconditionally, or 
on the basis of the zero or carry flags (JR, JR Z, 
JR NZ, JR C, JR NC). This does not provide the 
options available when using the absolute jump 
(which can act on the status of the parity and sign 
flags), and thus presents additional coding 
demands. 

A special relative branch instruction, DJNZ e, 
automatically decrements the B register, and 
performs a branch to the indicated offset 
whenever B is not decremented to zero. 
Although this instruction can have many uses, its 
two-byte brevity makes it most attractive when 
executing loops. 
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The problem of branches outside the range of 
the +7F/-80 byte offset can be solved by 
inserting 'stepping stones' in the main program 
flow. At the end of any logical program section, 
two unconditional branches may be inserted: the 
first branch serves to skip past the second branch 
to prevent disturbing the program flow in that 
area. The second serves as a stepping stone for 
some branch which is too far (more than 127 
bytes) from its eventual destination. The 
program can be ordered judiciously so as to avoid 
overusing such memory-gobbling stepping 
stones. 

Indexed Addressing. One of the best features 
of the 6500 and 6800-series CPUs is their ability 
to address and manipulate memory without 
continually reloading a register or using an 
absolute address in an instruction's operand. In 
fact, using these processors would be incredibly 
cumbersome without this mode since they 
contain merely two storage registers (X and Y) as 
opposed to the Z-80's sixteen (B, C, D, E, H, L, B', 
C, D', E', H', L', R, I, IX, IY). 

The value of the indexing features was 
recognized by the Z-80's designers, who added 
them to the 8080's primitive instruction set. As 
with relative branch instructions, a single-byte 
offset may be added to the value specified by 
registers IX or IY in order to produce the address 
of the desired memory location: 



IX = 6AA1 
+ 01 



resu L ti ny 
addraBs: 6AA2 



IX ■ 6AA1 
+ 7F 



6B2C 



IX 



6M1 
+ A1 



6A42 



The address of the index registers themselves 
does not change; the resultant value is stored in 
temporary internal Z-80 registers while an 
instruction is being executed. For example, when 
IX = 6AA1 and the instruction - 

INC (IX + AD 

- is specified, the CPU temporarily creates the 
resulting address 6A42 and increments its 
contents. The value 6A42 itself is then discarded. 

When a desired value is outside the range of an 
indexed register, the instruction ADD IX,pp 
comes to the rescue. The designation 'pp' is for 
any of registers BC, DE, IX or SP, which can be 
assigned specific values representing a full 16-bit 
offset, rather than the 8-bit offset of the indexing 
itself. For example: 

IX = 57EB 
DE = 41 CC 
Execute ADD IX, DE 
IX = 99B7 
DE = 41 CC 



Since it is an offset rather than a specific 
address, and since it remains unchanged after the 
execution of ADD IX,pp, it becomes a perfect 
candidate for use in relocatable code. 

Instructions using the index registers can be 
particularly valuable when lookup tables must be 
accessed again and again. With these commands, 
any registers used as pointers may remain 
unaltered; they need not be redefined each time 
the lookup routine is used. An excellent 
application of the index registers for 
five-character string comparisons is found in 
William Barden's Z-80 Microcomputer 
Handbook. 

Relative Subroutines. No, there aren't any 
secret relative call-and-return instructions that 
Zilog never told us about. Rather, there is a way 
to create the effect of a relocatable call by using 
an index register in combination with relative 
branches. 



This method was detailed in my article, 
'Relative Subroutines for the Z-80', BYTE, 4:12, 
December 1979. It is a bit cumbersome at first, 
and makes it impossible to produce 'ROMable' 
code. In summary, here is how it works (see also 
Table IV): 

1. An index register is set to some point in 
the program. This becomes a reference 
point. 

2. The call is prepared by determining the 
offset from the end of the subroutine back to 
the main program flow. 

3. During program execution, the offset is 
assigned, (using the indexed instruction LD 
(IX+d), n) as the operand of a relative 
branch placed at the end of the subroutine. 

4. A relative branch is executed to the 
beginning of the subroutine. 

5. When the subroutine reaches the end of 
its execution, it moves back to the program 
in progress. 
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7000 


ReLati 
D0218070 


TABLE IV 
ve Subroutine Flow 

LD IX ,7080 ;IN PROGRAM AREA 








7040 
7044 
7046 


D03E08BF 
1B20 


L0 (IX+B),BF ; RETURN OFFSET 
JR $+22 jJUMP TO SUBR. 


7047 






7066 






7067 







1BBD JR $-41 ; "RETURN" INSTR. 

< NOTE THAT "BO" IN OPERAND ABOVE WAS PUT 
IN PLACE BY CALLING PROGRAM AT 7040. > 



This method requires careful program 
preparation in that the beginning and end of each 
subroutine must be within the range of the 
calling program, and the offset to IX or IY must 
be within the range of the end of the subroutine. 
If the offset is outside the range of these registers, 
a 16-bit offset can be created as described above 
under indexed addressing. 

There is another option to create relative 
subroutines using the Z-80, but it is not 
time-effective. This involves a ROM call to 000B. 



Jerry Lindsly of West Chester, Ohio, describes it 
this way: 

When faced with the problem of relocatable 
code when using subroutines . . . you can use a 
very useful routine in ROM. Essentially what it 
does is this: 



PUP 

JP 



HL 
IHL) 



Get return address to HL 
Return to celling program 



So after you call 000B the PC is in HL. A 
relative call is a little more complicated: 



CALL 
LD 
ADD 
PUSH 

LD 



ADD 
JP 



00BH 

DE.OBH 

HL.DE 

HL 

DE.NNNN 



HL.DE 
(HL) 



0ff6et from first byte 
pest JP IHL) . 
Use XOR A and SBC HL.DE 
if the call is negative. 



(Those interested in the various uses of this 
routine may write to Jerry at 8106 Quailwood 
Court, West Chester, Ohio 45069). 

One could use the equivalent to such a ROM 
call in the program itself. This might be 
desirable. Certainly, if programmers had not 
learned it over the past two years, then the recent 
ROM changes (and expansions in the Model III) 
might dissuade overuse of calls to the Level II 
ROM. 
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How the System Expands 

Unlike automobiles, refrigerators, or shovels, 
computers are hardly ever completely self 
contained. Even if their manufacturers pretend 
they are making a complete unit, the machines 
themselves seem to desire bursting forth from 
their shells, commanding us to create a tabletop 
electronic octopus. 

The reasons almost sound metaphysical: it 
needs more memory; it needs communications 
capabilities; it needs mass storage; it needs 
hardcopy ... to achieve these goals, expansion 
capabilities were made available for the TRS-80 
by means of an electronic hodgepodge called an 
Expansion Interface. 

The Radio Shack Expansion 
Interface 

The Radio Shack interface originally consisted 
of eight major sections : 

1. An extension of the keyboard's edge-card 
connector, initially reserved for a screen 
printer, but containing all the signals on the 
keyboard's connector. 

2. Two groups of eight sockets, together 
with address decoding, to read and write two 
16K banks of dynamic memory. 

3. A decoded input/output latch for parallel 
printer control. A 'Centronics compatible' 
electronics scheme is used, with a separate 
edge-card connector dedicated to the printing 
task. 



4. A set of decoded memory addresses and a 
LSI (large scale integration) chip for disk 
drive and input/output control. The disks are 
accessed through an independent edge-card 
connector. 

5. A decoded output latch for dual cassette 
selection and control. One input and two 
output jacks are integral to this circuitry. 

6. A decoded, input/output port for serial 
communications control, with accompanying 
terminal for an RS-232 circuit board. The 
RS-232 board is accessed via a separate edge- 
card connector. 

7. A crystal and divider circuitry to provide 
disk access, real-time clock, and other 
interrupt functions. 

8. Power supply circuitry. 

If it seems like a lot of unrelated material to 
pack into a single box, then you're on the right 
track - the track that, for quite a while, meant 
trouble. The electronic clamor inside this box 
was to create a system -crashing din during the 
first year or so of expansion interface 
manufacturing. 

The problems were manifested by memory 
crashes (return to MEMORY SIZE?, keyboard 
lockup, or, in a disk system, complete reboot and 
so on). There were several culprits, but the 
gangleader was the misconceived design itself. 
Putting all that material on a single board was 
inviting trouble, and the actual execution of the 
circuitry compounded it. The main difficulties 
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were memory refresh/select, noisy and dirty 
connectors, weak buffering lines, microphonics, 
and susceptibility to external interference. 

The memory refresh/select lines were noisy 
and unreliable. The purpose of the refresh lines 
is to read the entire memory in intervals of two 
milliseconds or less. The memory-select lines 
provide the signals to select one of the 65,536 
possible addresses when needed by the CPU. 

In many computers, selecting a memory 
address is a fairly straightforward process. The 
CPU signals a memory request of some kind, 
and provides an address on the address bus. The 
selected memory responds by providing or 
accepting data according to the direction of the 
CPU. On the TRS-80, however, type 4116 
dynamic memories are used. These memories 
do not have enough external pin connections to 
accept a complete memory address. Instead, 
hardware breaks the address into two parts, 
which are transferred sequentially. 

Briefly, this is how it works. The address is 
sent out on the address bus. The CPU also 
provides a 'memory request' (MREQ) signal 
which triggers special circuitry. This special 
circuitry stands between the address lines and 
the dynamic memories. This circuitry produces 
a multiplex signal - MUX - which chooses the 
low seven bits of the address. It then sends those 
bits together with a 'row address strobe' - RAS - 
to the memories and reverses the MUX signal to 
choose the high seven bits of the address. Then 
the special circuitry sends those bits together 
with a 'column address strobe' - CAS - to the 
memories. 

This sequence of operation provides all the 
address information needed by the dynamic 
memories to select an address. The three items 
most crucial for smooth memory action are the 
RAS, CAS and MUX signals, and as such, these 
should be clean, noise-free lines. Within the 
confines of the keyboard unit, this is the case. 
But once forced to travel through a cable (via 
two solder-coated edge connectors) into the 
expansion interface, the signals pick up some 
measure of noise. Once inside the expansion 
box, the noise is increased by the surrounding 
electronic din (remember that a separate crystal 
is onboard), and the requirement that these 

signals feed many other devices reduces their 
effectiveness. They become electronically tired, 
and memory access becomes erratic and 
susceptible to external electrical influences. 

Thus, memory selection was impaired and 
memory refresh was not necessarily executed 
successfully in less than two milliseconds. 



The next culprit in the expansion box was the 
lack of 'buffering'. In the Technical Reference 
Handbook, the author points out that among the 
requirements for hardware are that it : 

4. Contains a separate power supply. 

5. Does not contain more than 1 LS TTL 
load on any one output from the Computer. 

Points 4 and 5 are very important, if you want 
to guarantee proper operation of your Computer. 
Radio Shack, not taking its own advice, hangs 
five LS TTL loads on data line 0, and four on 
each additional data line. If an RS-232 board is 
installed, that becomes another load. The 
address lines feed as many as three devices. With 
a screen printer or other device connected to the 
expansion interface this load increases, 
respectively, at least once for each additional 
device attached! 

The third system-crashing factor is an 
unusual one, avoided by good circuit board 
layout, but not always anticipated. This is 
covered by the rather unusual term 
microphonics. In other words, when the 
expansion box circuit board is tapped or 
vibrates, those vibrations are amplified and 
communicated throughout the entire circuitry 
by the power supply, data and address lines. 

The keyboard unit can take a hefty bounce. If 
you're brave, give it a try by dropping it six or 
more inches. Chances are a running program 
won't crash. But rap sharply on the expansion 
box with the program running, and . . . you can 
guess. These strong pulses are not in the high- 
frequency range which the 'bypass' capacitors 
(the small disc capacitors scattered throughout 
the computer) can squelch; rather these are 
heavy, low-frequency surges which can be 
electronically interpreted as signal changes. 
Hence, the crash. 

Finally, the electronics, being spread out in a 
plastic case, are subject to the electrical whims 
of the outside world. Seated directly below the 
video monitor, the expansion box is susceptible 
to any strong noises contributed by the monitor, 
or through the power lines and rebroadcast by 
the monitor's circuitry. Printer heads and 
motors, disk drive motors, and what have you all 
let the expansion box know they are operating. 

So it responds by crashing its sensitive and 
overworked memory circuits. 

Several solutions have been created. The first 
was that bulge between expansion box and 
keyboard unit: the buffered cable. The second 
was the 'twisted pair' modification, another 
bulge between the boxes. The last was a 
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rethinking of the expansion circuitry and 
redesign of the board. The last was the only one 
that worked. 

The idea behind the buffered cable was sound 

- to strengthen the overworked signal lines by 
having them feed a single integrated circuit 
each, and then have that integrated circuit feed 
the expansion box. Furthermore, 'termination 
resistors' could then be added, which work 
something like this: power supply lines contain 
bypass capacitors to squelch noise, but placing 
capacitors on the signal lines would slow down 
important signals as well. Instead, low-value 
resistors could make the signal lines 'hug' the 
power supply and ground lines, increasing their 
resistance to low-level, transient, electronic 
noises. 

First installation of buffered cables were less 
than successful, partly because the three 
memory-select signals were very fast signals 
delayed too long by a combination of buffering 
and transmutation inside the expansion box. 
Thus, these lines were pulled outside the 40-pin 
cable via a three-pin DIN connector, separately 
terminated. This kept them up to speed, but 
isolated them from the accompanying noise. 

Nevertheless, these modifications were only 
making up for difficulties inherent in the 
expansion box design, and could not improve the 
box's susceptibility to noise all around, or its 
microphonic tendencies. 

The solution was to put the buffers on board 
the expansion interface itself, and redesign the 
board to reduce interference. New memory- 
select lines were created by the RAS line alone to 
eliminate noise in these signals, but the method 
used was to create problems concerning speed 
modifications (which, of course, Radio Shack 
did not authorize and could not consider in its 
redesign - see the way out of this problem later in 
this Chapter). 

These difficulties, though, should be placed in 
perspective. When connectors are well cleaned, 
good memories are used to stock the expansion 
box, and the computer's environment kept 
clean, static-free and vibration-proofed, even 
the first, unbuffered systems work successfully. 
My own system (on which this book is being 
prepared) is a 48K, one-disk system with RS-232 
board, printer, two modems, Exatron Stringy 
Floppy, two cassettes and home-brew interfaces 

- all connected to an unbuffered expansion box 
of early vintage. But it must be cared for. The 
designers were simply not prepared for the TRS- 
80's ultimate home and business environment. 



One increase in reliability is not mentioned in 
the Radio Shack redesign. Electronic parts are 
'derated' according to temperature. That is, as 
temperature increases, their performance 
decreases. Some circuits, like 74LS types, are 
strong and steady right to the limit; others, 
particularly dynamic memories, become flakey 
as the heat builds up. Thus, reliability of the 
expansion box can be improved by removing the 
two power supply transformers from the 
expansion box. 

Solving the Ground Problem 

I call this a ground problem, but it really 
refers to the microphonic tendency of the 
expansion board. The first and easiest solution 
is to remove and cushion the expansion circuit 
board. One principle of vibration-proofing is 
that when different materials are sandwiched 
together, a certain amount of sound and 
vibration energy is reflected back from the 
junction of the different materials. 

Thus, all sources of potential vibration should 
be cushioned. Set a thick cloth (like terrycloth) 
on your computer desk, and a wooden baseplate 
atop that. On it, place a mat made up of several 
thin layers of plastic pad, rubber foam, and 
cloth to a thickness of about 1/4 to 1/2 inch. 
Assure that the keyboard unit and interface seat 
comfortably in them (you might drill shallow 
depressions in the wood for stability), but that 
there is some air space for cooling. Remove all 
the plastic doors which attach to the interface 
and discard them. In their place put rectangles, 
made of alternating layers of cork and 
styrofoam, which snuggle firmly between the 
connectors and the umier and lower walls of the 
case. See Figure 5-1. 




Figure 5-1. Shockproofing diagram. 

Other sources of vibration are the cables that 
attach to the expansion box. Rather than have 
cables vibrate and swing with a printer, or stretch 
when you readjust the position of a disk drive or 
modem, sandwich each one under a leather (or 
synthetic plastic, if you prefer) bridge, and screw 
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Photo 5-1. Photos on opening the expansion box. 
Screws are removed from bottom; note that like the CPU, a 
warranty- warning label may cover one screw. 




Bottom is lifted off to reveal top of expansion circuit board 
Screws holding circuit board are then removed 



the ends of this bridge through the cushion pad 
into the wooden base. When jostled, the cables 
should not move between the bridge and the 
expansion box. 



Finally, avoid the possibility of stretching the 
keyboard/expansion box cable. The best way is 

to drill shallow depressions in the wood base, as 
noted earlier. 

These are not specifically electronic hardware 
corrections, because only a thorough redesign of 
the expansion interface can truly cure these 
microphonics problems. 

Expanding to 32K and 48K Memory 

Memory expansion in the interface itself is 
quite simple. Remove power from the interface, 
disconnect cables, and lift out the power supply 
transformers. The latter action is necessary 
because the power supplies will only fall out 
anyway when the bottom comes off. Flip the 
expansion box over, and remove the six black 
Phillips screws. Lift off the bottom cover. 

There are sixteen unfilled sockets on the 
board, reserved for memory expansion (see 
Photo 5-2. The higher-numbered sockets (Z- 
9 to Z- 16 will be used for the first block of 
memory, for a 32K total RAM. The lower- 
numbered sockets expand the system to the 
complete 48K. 

The memories to be used are type 4116, as 
used in the keyboard unit (see Chapter 4). 
There are some differences, though. Oddly, 
some sources claimed that slower memories 
seemed to work better in the older interfaces, 
but fast 250 nS RAMs are the most commonly 
available now. I have not come across an 
expansion box of any vintage that could not take 
fast RAMs like these, including my own, which 
dates to early 1978. 

First, refer to Chapter 3's notes on handling 
static sensitive integrated circuits. Take each 
RAM and orient it with its notch or dot at the 
top facing in the same direction as the notch in 
the sockets (and in the same direction as the rest 
of the integrated circuits on the board) . Fit each 
one of the first eight chips carefully in place, 
being sure that the pins slide into the sockets 
and neither buckle underneath the IC nor slip 
outside the socket edge. Press the memory chip 
gently but firmly in place. 

Now, before installing another 16K memory 
block, test this group. Flip the expansion box 
over (the cover need not be installed), reconnect 
cables and power supply, and power up the 
expansion box. While holding (BREAK), power 
up the computer itself, and press (ENTER) in 
response to MEMORY SIZE. Now PRINT 
MEM, and a figure of 31956 will be displayed. If 
all is well, power down, remove cables, and 
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insert the remaining eight memory chips. Again 
restore cables and power, and go through the 
initialization procedure. Memory should now 
read 48340. Replace the cover and cover screws, 
and you're set with an expanded system. 

Problems? If there are any, they will likely fall 




IfRS-232 board is in place, the two screws holding it must also be 
removed 




Entire expansion card lifts out easily. 



into these categories: 

1. PRINT MEM returns 15572 or some 
figure much below the expected 32K value. 

2. The system continuously crashes back to 
MEMORY SIZE? or just locks up. This 
happens most often while running any 
program. 

3. The system just locks up with garbage on 
the screen at power-up. 

Well, the last first. Don't forget to hold the 
(BREAK) key down at power-up in a non-disk 
system. The other two are tougher. 

If PRINT MEM returns 15572, you might 
have installed the memory incorrectly. Keep 
booting (press the Reset button while holding 
down (BREAK)), and hitting (ENTER) in 
response to MEMORY SIZE? PRINT MEM, 
checking over and over. If a figure higher than 
15572 is ever returned, you might have expansion 
box problems. 

Try entering a number between 15580 and 
32700 in response to MEMORY SIZE?. If it is 
ever accepted, chances are you've got the 
memory chips installed correctly. Try POKEing 
and PEEKing, like this : 

POKE 25000,100 : PRINT PEEM 25000) 
POKE 26000,103 : PRINT PEEM26000) 

and so on. If the value you POKEd is the same 
as what you PEEK at, the memory is there, but 
it's not acting reliably. Here are a few solutions 
(see also the expansion box general solutions 
above) : 

1. Clean cables, connectors, etc., and shock- 
proof the unit. 

2. Remove the buffered cable if you have one, 
and replace it with a regular one. Before you 
do this, open the expansion box and find pin 
#1 on the edge connector. Cut that trace, 
or remove the wire you see there. This is the 
5- volt power supply to run the buffering box. 
The matching pin on the keyboard unit is a 
ground! 

3. If you have a newer expansion box, make 
the high speed alteration noted above, 
although you shouldn't be having these 
problems with the new box. 

4. You actually might have some flawed 
memory chips, though this is unlikely. 
Switch those in your keyboard unit with those 
in the expansion box, and see if the problem 
goes away (or the keyboard unit doesn't work 
now). Run the memory test (Chapter 3) to 
find out which chip(s) may be bad. 
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Photo 5-2. Expansion interface memory sockets. 
32K memory fits into sockets Zl through Z16. Oddly, Tandy 
engineers did not install power supply filter capacitors C54 and 
C55, nor are they included in the schematic drawing. 



5. Make the small change to Z69 in the 
keyboard unit, as described in the 200% 
speed-up modification. 

The options are few when dealing with an 
older expansion box. They will work, but you 
have to provide them with ideal conditions. 

Which points out the solution to the possible 
program crashes noted in problem number 3 
above. Pamper the expansion interface when a 
program is running. Don't have the kids playing 
kick-the-cat near the computer, or the dog 
jumping about and thumping a large tail next to 
you, waiting to be fed. Keep the washers, driers, 
and mixers in the vicinity switched off. 

Speeding Up Newer Expansion Boxes 

Radio Shack's cures for the memory 
refresh/select difficulties in the expansion 
interface created a new problem for those who 
wish to increase the speed of the computer. All 
three select lines (RAS, CAS, and MUX) are not 
used in the revised expansion box; instead only 
RAS is used. 

Technically, the RAS line is sent thrice 
through an inductance network which provides 
three differently delayed doppelgangers of the 
original signal. These are tweaked back into 
digital shape by a buffer circuit, and the three are 



labeled MRAS, MMUX, and MCAS. The ploy 
works. 

Trouble is, these lines don't care about the 
speed of the central processing unit. Fast or 
slow, the false MMUX and MCAS signals trip 
along at a fixed rate after MRAS. The only cure 
is to somehow speed up that rate and buy fast, 
high-quality memory. The speedup is 
accomplished by not delaying the RAS to 
produce MRAS, and creating MMUX and 
MCAS in the old MRAS and MMUX positions, 
respectively. The faster memory (200 nS) is up 
to you. 

To provide the speedup, you'll need to cut 
some traces and run some wires. Remember, this 
adjustment is for newer expansion boxes only - 
the ones that the sales clerk says "don't need the 
buffered cable". Here is the order : 

1. Find Z37 and Z38. 

2. Cut the trace leading from Z38, pin 9. 
Call the end furthest from Z38 'Trace A'. 

3. Cut the trace leading from Z38, pin 8. 
Call the end furthest from Z38 'Trace B'. 

4. Cut the trace leading from Z37, pin 4. 
Call the end furthest from Z37 'Trace C. 

5. Attach Trace A to Z38, pin 11. 

6. Attach Trace B to Z37, pin 4. 

7. Attach Trace C to Z38, pin 9. 

The modification is complete. Close the box 
and power up again; the system should work 
normally (if not better as time goes by). Both 

higher speed modifications presented in Chapter 
4 will work with these changes, so long as your 
memory is the faster, 200 nS type. If the 
memory seems at all unreliable, double-check 
your work. If the work is fine, then your memory 
may not be up to the change. 

LNW, Microtek and Other Expansion 
Interfaces 

The first of the TRS-80 products to be 
attacked, and rightly so, was the flakey 
expansion interface. By the time Radio Shack 
was offering its initial hopeless 'fixes', a trio of 
Californians were redesigning the box for their 
colleagues in a TRS-80 user group. This was to 
become the premier challenger to the expansion 
interface, the LNW System Expansion, priced at 
a mere $70 for the bare board, circuit diagrams, 
parts placement, and a few additions to the 
Tandy system. 

The LNW System Expansion is essentially the 
Radio Shack expansion interface with a new 
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Using Those 4K Leftovers 

Did you insist on keeping the 4K RAMs 
which were removed from the keyboard unit 
when your 16K RAMs were installed by Radio 
Shack? Or did you do the installation yourself? 
If so, you've got 4K of dynamic memory worth 
about $20 off the shelf. But the trouble is you 
can't use them in your expansion box, because 
it's set up for 16K memories only. 

But, if you want to spend a bit of time and 
can't afford an expansion interface, you can 
extend that PRINT MEM to 19668! Almost 



everything is in place already, so all you need is 
an address decoder and multiplexer circuit. 

The circuit presented below can be wire 
wrapped on a small board, and will provide that 
extra 4096 bytes. The cost? About $5 for circuits 
and sockets, another $5 for an edge connector 
(use the Texas Instruments wire wrap type sold 
by Digi-Key, part number C6-20), and some 
time. 

When you begin to fill your expansion 
interface, though, you'll have to give up the 4K 
RAM extension, because the first block of 16K 
memory in the box takes those memory 
addresses. 




Figure 5-3. 4K dynamic RAM add-on circuit 
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Hefty power supply includes fuse and multiple heat sinks, unlike 
TRS model with inaccessible fuse and light heat sinks. 



layout, on-board buffers (which appeared finally 
on Radio Shack's own product in the spring of 

1980), standard RS-232, and noise-reducing 
passive bus termination. This last was of 
particular importance in making the LNW 
board noise-free and consequently crash-free. 

As with the Radio Shack expansion, the LNW 
board has sockets for 32K additional RAM, but 
also suggests that sockets be used for all parts - 
good advice, especially since chips such as the 
open-collector buffers used in the disk line driver 
need occasional replacement. 

This board is also modular in a way that the 
complete, boxed interface from Tandy could not 
be. Only as much as the user needs at one time 
may be installed. Thus, the $25 disk controller 
chip can be left out of the system until (or if) a 
disk drive is added; so also the disk's peripheral 
chips can be omitted. Where interrupts are not 
desired, the entire crystal controlled clock can be 
excluded. Less than $150 gets the user a 
bare-bones 32K memory expansion. 

The trick to the LNW board is dexterity. This 
is not a project for total novices, because it 
involves extensive soldering and some 




LNW Expansion compared with TRS-80 monitor. Board is 
Oapproximately the same size as standard TRS expansion interface 
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Communications are built into LNW expansion; TR1602 UART 
provides serial capabilities. Note clear marking of all parts, 
including an industry part number at the UART socket 



knowledge about what the parts look like. There 
is no Heathkit-style check-off list. You get a 
parts layout, schematics, and encouragement. 
But you also get a noise free, reliable expansion 
interface. 

For those who plan to build (or have already 
built) the LNW board, a few changes might be 
in order. If you wish your reset button to work, 
you must not only make a change similar to that 
for the Radio Shack expansion box, but you 
must also change the values of the pull-up and 
pull-down resistors. Change the pull-up 
resistors on the data lines to 470 ohms, and the 
pull down resistors to 680 ohms. This will 
provide the desired 11111111 signal when the 
reset key is hit and the disk buffer-disable 
modification has been made. 

To make the mod, turn to the expansion 
interface reset recovery presented in Chapter 
(?), and follow those same directions, but using 
the integrated circuit on the LNW board marked 
U19. 




Virtually complete LNW board in use. User has added 
programmable baud rate generator (bottom right) in place of 
hard-wired jumpers recommended by LNW Research. 



Special Section: Two Other 80s 

The PMC-80. 

As production of the TRS-80 Model I was 
winding down at Tandy, the rumored 'Hong 
Kong Copy' made its appearance in the United 
States, under the name PMC-80, and sold by 
Personal Microcomputers, Inc., of Mountain 
View, California. 

I was personally ready to greet the PMC-80 
with much skepticism, expecting a weaker 
TRS-80 with little to commend it and a lot to 
avoid. But, tacky advertising aside, the PMC-80 
is a functional, satisfactorily designed product. 
In fact, because of the experience of the original 
'80 itself, this copy is probably better designed 
than Tandy's product. That's probably an 
indirect compliment to both Fort Worth's 
foresight and Microsoft's Level II BASIC, which 
the PMC-80 contains virtually byte for byte. 

First, the obvious similarities : 

1. Z-80 microprocessor running at 1.77 MHz. 

2. 64 x 16 screen resolution, with 128 x 48 
graphics. 

3. Video monitor output compatible with 
the Radio Shack monitor. 

4. Microsoft Level II BASIC in a 3-chip 
ROM set and standard type 4116 16K 
memory. 
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And then, the differences 




Photo 5-3. The Z-80 CPU — Used in the PMC-80. 



1. Built-in cassette player with no level 
control necessary, with provision for two via a 
second cassette jack already in place. 

2. Video RAMs are in sockets, all seven are 
installed for lower case use, and an industry- 
standard character generator is used. Lower 
case is not provided, but is available. 

3. An oversized, well- ventilated power supply 
feeds the system. 

4. Channel 3 RF video is provided, along with 
a connector cable and adaptor. 

5. Keyboard has a cassette motor on/off 
control, but is missing clear and right-arrow 
keys. These can be installed by the user on 
some machines. 




Complete PMC-80 system can include CPU unit with cassette, 
printer, expansion box, monitor, and disk drives. Photo courtesy 
of Personal Micro Computers, Inc. 
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6. An odd 32-character mode, selected 
differently (with a switch). Instead of 
alternate letters in video memory, the 'left 
half of video memory is used. Normal 
CHR$(32) is shown instead as normal-size 
letters appearing alternately on the screen. 

7. The keyboard types easily, with no 
evidence of key bounce. 

8. The expansion connector is gold-plated, 
but the inter-board and keyboard connectors 
are just solid wires pushed into receptacles. 
Heavy duty relays are used for the dual- 
cassette I/O. 

9. The gold-plated expansion connector, alas, 
is not a TRS-80 compatible 40-pin type. The 
PMC-to-TRS adaptor is an option. 



Are the TRS-80 and PMC-80 software- 
compatible? From what I can tell after running 
both BASIC programs and machine language 
utilities employing calls to ROM: yes, with 
minor reservations. First of all, the missing clear 
and right arrow keys are a downright pain; users 
of programs such as Scripsit or the Penmod 
version of Electric Pencil are back in the good 
old days of having to add keys to the system to 
get these programs to work. 

Major ROM calls, though, seem to be intact, so 
there's little worry about compatibility there. 
The only programs that seem to get lost are those 
that call inside routines, or that call partial 
routines in ROM. BASIC runs flawlessly, as do 
mixed BASIC/machine programs. 




Inside the PMC-80. Keyboard, two electronics boards, cassette 
player, and power supply are attached to the baseplate. 
Multiconductor wire jumpers plug in place. 
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Keyboard connector attaches to main board via a removable 
cable, a distinct improvement from the permanent TRS-80 cable. 
Note Z-80 CPU underneath cable. 




Hefty power supply provides drive for computer electronics as 
well as a separate supply for the cassette recorder. Fuse is user- 
replaceable, in a standard socket. 



Other comments : 

The video display is cleaner, and the letters 
are better formed, prettier, and with no touch 
of blurring, even on the inexpensive TRS-80 
monitor. They are quite similar to the better 
quality characters of the TRS-80 Model III. 
The lowercase option was not installed in the 
unit I used, but since it uses the standard 
character generators and has a clean video 
output circuit, similar well formed letters can 
be expected. 

Cassette input/output is sweet. Problem 
programs loaded easily with this system. 
The playback of the cassette deck is 
digitized with LM324 comparators instead of 
3900 Norton amps, and so the digitization is 
more successful. 

The overdesigned power supply shows every 
sign of providing plenty of surplus current. 
There is no need for power supply 
adjustment in this system, because in place 
of the adjustable 723 regulator used in the 
TRS-80, fixed 7812 and 7805 regulators are 
employed. 

The unit, though heavier than the TRS-80, is 
more complete in the sense that it has a built- 
in cassette player and RF video output. For 
traveling, the PMC-80 makes much more 
sense, because a video monitor can be used in 
long sessions at home or office, and an 
ordinary television can be used at other times. 
The case is tacky, especially the fake walnut 
grain plasticoid sides, but then the down-to- 
business futura TRS-80 was no great 
aesthetic shakes, either. The keyboard is 
placed at a comfortable angle, and the added 
weight and size gives the unit a more 
responsive typing feel. 



The LNW-80 Kit. 

This is a welcome newcomer, providing the 
advantages of the Model I with LNW's well 
respected circuit board. As with their system 
expansion, this LNW board is sold naked. The 

user contributes the parts as required. 
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CPU control card contains 3-chip Level II ROMs, 1 6K dynamic 
memory, and power supply. Circuit board design isn't pretty, but 
is very reliable. 




Video display card includes 7-bit video memory (unlike original 
TRS-80 6-bit memory), industry- standard CGR-001 character 
generator, RF modulator, and sockets for video memory chips. 



CPU Interruptus 

The interrupt is a programmer's mystery tool. 
On large machines the interrupt controls are so 
sacred that they are available only to the system 
engineers. Without a password, assembler 
commands directed toward interrupts are 
generally ignored. 

TRS-80 users might have in mind some 
dreams of the Z-80's interrupt power. They've 
heard of it. Allusions have been made to it. Yet 
because it operates outside familiar 
programming bounds, it is even now a mystery. 

Furthermore, this may be one of those cases 
where the Tandy engineers seriously erred in the 
concept, (rather than in the design, which 
problems we know all too well). The inclusion of 
additional interrupt power could have been done 
for pennies. 

Whatsis? 

The activities of a computer program can be 
viewed in relative rather than real time. In other 
words, a computer performs its tasks in the order 
that the programmer has chosen, with a timing 
that is inherent to the oscillations of the 
computer's master clock. Change the spacing of 
those oscillations, and the absolute time - the 
time with respect to 'real' time - changes, yet the 
relative time within the computer program is still 
the same. 

Unfortunately for timekeeping purposes, 

changing either the clock of the computer, or 
changing the way in which the computer handles 
its tasks, may actually cause a shift in the real 
time reported to the user. An interrupt, then, is 
electronic shoulder tapping, the ability of a 
device external to the microprocessor and its 
respective memory to demand the CPU's 
attention for imperative tasks. For example, an 
external pulsing clock says to the CPU, 'Okay, I 
don't care what you're doing, stop it now and 
take care of updating of the real-time clock.' 

Such is the simplest use of an interrupt. And, 
for a change, the computer jargon term is true to 
its actual purpose. It interrupts the operation of 
the central processing unit, demanding 

attention. 

An interrupt is akin to a ringing telephone. As 
long as you are within earshot, the ringing of the 
telephone interrupts your activity. Whether you 
choose to respond consciously to it is irrelevant to 
the actual interruption. If you can hear, and if 
you are within hearing range of the bell, it does 
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indeed influence the activities of your nervous 
system. 

How you respond to that ringing telephone - 
whether you ignore it, whether you go to it and 
answer it, or whether you merely swear at it - is 
what might be called, in computer terms, 
'servicing the interrupt'. 

The Z-80 microprocessor contains a wide range 
of ways in which an interrupt may be 
acknowledged, received, or serviced. You 
respond to a knock, doorbell, telephone, child's 
cry, or gunshot with various levels of urgency. If 
more than one were to occur about the same time, 
you would be forced to mask out the one of lower 
priority and give your attention to the more 
pressing interruption. 

Before describing the ways the Z-80 
microprocessor might respond to an interrupt, it 
should be noted that an interrupt is uniquely 
different from the computer's usual 
input/output schemes, just as the ringing 
telephone or gunshot are considerably different 
from checking the color of a traffic signal as you 
approach it; inspecting the mailbox as you arrive 
home; or scratching the cat. 

In these analogies, your ears most often serve 
as your human interrupt line. As long as they are 
'in the circuit', they will interrupt you. You can 
close your eyes to the traffic signal, ignore the 
presence of the mailbox by averting your glance, 
or cold-shoulder the cat (at your own risk), but 
(lacking earflaps), sound will give you an 
appropriate kick in the eardrums. 

Back to the Z-80's interrupt schemes. During a 
movie, were someone to yell "Fire!", chances are 
that everyone - barring suicides and 
existentialists - would respond to that 
interruption with their personal interrupt 
service routine. Most likely that routine would be 
to leave the theater quickly. 

An equivalent reaction by the Z-80 is produced 
by a signal applied to its 'non-maskable 
interrupt' (NMI). This interrupt is always 
acknowledged. The CPU cannot ignore it. On the 
TRS-80, it is this interrupt which is activated 
when the Reset button is pressed. 

The NMI is hard-wired into the system in such 
a way that we have no control over it, so that if 
these sentences were a program . . . 

READY 
>_ 

. . . and not only that: the execution of a HALT 
instruction produces a 'Halt Acknowledge' 
output signal which the Tandy Engineers have 



OR-gated with the NMI to ... 

READY 
>_ 

. . . yup, you guessed it. 

Contrarily, the Z-80 has a maskable interrupt 
(INT). It is an interrupt line which, when 
activated, may either be ignored or 
acknowledged by the processor if the 
programmer has so specified. 

Because their activities are not fixed, these 
maskable interrupts are the ones of interest to us. 
Although, as I've said, the Z-80 was designed with 
a wide range of interrupts, that wide range is not 
accessible to TRS-80 users because the Tandy 
engineers did not design the TRS-80 in a way 
that could make those interrupts available. 

Nevertheless, here is a look at the Z-80 
interrupt modes. 

Mode 0. This mode allows the interrupting 
device to place a machine language 
instruction directly on the data bus. The CPU 
will then execute that command rather than 
the next instruction in the normal program 
flow. Designers of the Z-80 suggest that a 
restart (RST) instruction be used. 

Restarts have been covered in The Alternate 
Source and other publications, but briefly, they 
are single byte subroutine calls especially 
designed for this kind of interrupt operation. 
Normally, subroutines require specification of a 
CALL instruction (CD) and two absolute 
address bytes. The RST instruction is a single 
byte command causing the CPU to stash the 
program counter on the stack and move to one of 
eight locations in low memory. 

Mode 1. Upon interrupt, this mode forces the 
CPU to preserve the program counter and 
then move directly to location 38. 

(line to absorb indent) 
Mode 2. This is considered the most powerful 
interrupt response mode of the Z-80 because 
"the programmer maintains a table of 16 bit 
starting addresses for every interrupt service 
routine . . . When an interrupt is accepted, a 
16 bit pointer (is) formed to obtain the desired 
interrupt service routine address from the 
table. The upper 8 bits of this pointer (are) 
formed from the contents of the I register. The 
I register must have been previously loaded 
with the desired value by the programmer. 
The lower eight bits of the pointer must be 
supplied by the interrupting device...." (from 
Z-80 Technical Manual). 
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Before you permit excitement (or even a 
raised eyebrow) about the last interrupt mode, it 
should be pointed out that neither Mode nor 
Mode 2 may be used on the TRS-80, for this 
hardware reason: in order to place any 
instruction or address on the data bus, it must 
be possible to configure the data bus as an input. 
Within the internal circuitry of the TRS-80 
itself, the data bus is fully bidirectional. This is 
normal, because the data bus is in an input-to- 
CPU state whenever memory is being read or 
input intructions are being executed, and in an 
output-from-CPU state whenever information is 
being stored in memory or output instructions 
are taking place. 

Unfortunately, only the data output is 
brought to the edge card of the TRS-80. There is 
no buffer wired to the edge card which is pointed 
inward to the CPU, activated when the IORQ 
signal is sent from the CPU during interrupt! 
Therefore it is impossible to place either an 
instruction or an address byte on the data bus 
from outside the computer. 

(Of all the possible under-utilization of the Z- 
80's power in the TRS-80, this is to me the most 
discouraging. You can cure something like the 
stingy lack of an extra video bit for lower case, 
but adding a second set of buffers requires a true 
hardware hacker. You might as well build a new 
computer. Aveatquevale, Model I.) 

Thus, the balance of this section will be 
concerned exclusively with interrupt Mode 1 (set 
by executing the command IM1). As noted, the 
execution of this instruction forces the CPU to 
address 38. 

Address 38 has also been usurped by the TRS- 
80 designers by placing it in ROM (read only 
memory). Because the first act of the instruction 
at 38 (which incidentally is the last of the RST 
instructions) is to jump into RAM at 4012, it can 
nevertheless be accessed easily. 

With a Level II CPU unit alone, the edge-card 
connector is brought out so the interrupt line is 
present. However, if you are an expansion 
interface owner or disc user, then you should 
know that the interrupt itself is dominated by 
the expansion interface unit's clock, which 
places a constant 25-millisecond pulse on the 
interrupt line. Therefore, not only are interrupt 
modes and 2 made unavailable by the TRS-80 
design, but (unless you are willing to cut a trace) 
the presence of the expansion interface limits 
even the use of Mode 1. 

Despite all these limitations (whew!), the 25 
mS interrupt does allow options beyond just the 



real-time clock. 
Which brings us to the reason the Z-80 has so 

many interrupt modes. The most powerful kind 
of interrupt places an instruction or address on 
the bus, directly influencing CPU activities every 
time it occurs, but only when it is needed. If the 
hardware is well designed, this means every 
interruption is essential, and is handled 
expeditiously. 

On the other hand, 'polling' interrupts for 
service requests is wasteful. That is, when there 
is a single interrupt mode which all devices must 
use, then the CPU is forced to ask each one, 'Did 
you interrupt me? No? Well, did you interrupt 
me? No? Well then, did you interrupt me? No? 
Okay, then . . .', until it finds the culprit. It not 
only services it, but also checks the remainder of 
the devices in case other interrupts occurred 
simultaneously with the first, or during the 
interrupt service routine. 

We are therefore limited not only to a single 
interrupt mode, but also to a required polling 
technique, because this 40-times-per-second 
pulse is coming through without cease. No real 
'device' is asking for service, but the effete 
request is present nonetheless. Yet we can still 
use it. Here's how: when the interrupt comes 
through, the CPU sends a signal to the relatively 
few devices in our I/O scheme, and asks them, 
'do you have any information?' If there's no 
information, the CPU will quickly beat a path 
back to normal program flow. If there is 
information, the CPU will service the interrupt. 

Whysis? 

You may wonder what type of situation — 
within the context of the humble TRS-80 itself 
— might require this interrupt, other than the 
familiar real-time clock. Let's take an example 
of flawed human interaction in TRS-80 
programming: the Electric Pencil. 

As any reasonably good typist knows, this 
'text editing' program is infuriatingly slow at the 
end of lines, particularly at the bottom of the 
page. Not only must it move the word in progress 
to the next line, but also scroll all 1,024 
characters up the screen. If you are nimble- 
fingered, you can lose characters during this 
process. 

The interrupt system might be used in order to 
build a buffer of keys pressed. A good typist's 
fastest keystrokes ('the', 'is', etc.) can be less than 
50 mS apart, or 20 characters per second. As the 
interrupt comes through from the expansion box 
40 times each second, location 387F can be 
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examined by the CPU. If any key other than 
'shift' is pressed, its presence can be sensed by 
looking at this location. If its presence is sensed, 
the key-scan routine can be initiated, and the key 
information and any successive keystrokes are 
stored until the line break and/or scrolling is 
completed. 

In this way the keyboard may be 'scanned' 
quickly, not only during entry of text, but also 
during I/O, such as to tape. A keystroke buffer 
may be built during this process (since the 
keyscan need only be initiated if a key is pressed) 
between output bytes. The same is true of 
printing; the text can continue to be output to the 
printer while this activity is going on. 

In fact, if a key were pressed during an I/O 
routine, it could be accepted into a buffer, and 
subsequently displayed when the next interrupt 
occurs. In effect, you would be time-sharing your 
TRS-80. 

Light Bulbs 

Aha! Time-sharing your TRS-80! (Light bulbs 
flicker on in millions of brain rooms). Although a 
25-mS pulse does not allow totally transparent 
time-sharing, it allows enough of it for your 
TRS-80 to be able to service several user 
requests at a time, in different ways. 

But first, here's a short routine to prove that 
the interrupt is really there. You can assemble 
this, or just POKE it into memory. 



7FD0 F3 




DI 




interrupts off 


7F01 3E C3 




LD 


A.0C3H 


;Get JP command 


7FD3 32 12 


40 


LD 


(4012H1 ,A 


;RepLace RET cmd 


7F06 21 14 


7F 


LD 


HL.7F14H 


;Stert service 


7F09 22 13 


40 


LD 


(4013H),HL 


;Place after JP 


7F0C 21 19 


1A 


LD 


HL.1A19H 


; Command level 


7F0F E5 




PUSH 


HL 


;Ready to return 


7F10 EO 56 




IN 


1 


(Set to Mode 1 


7F12 FB 




EI 




;Interrupts on 


7F13 C9 




RET 




;Return to 1A19 



The segment above is merely a setup routine, 
executed once. It disables interrupts during 
setup, places C3 (a jump instruction) in place of 
C9 (return) currently found at 4012, the 
interrupt patch point in RAM. It then places the 
destination address (7F14) as the jump's 
operand. It pushes the return to BASIC or DOS 
onto the stack, sets interrupt Mode 1, enables 
interrupts, and returns (effectively jumping to 
1A19). 

Note that after an EI (Enable Interrupts) 
instruction, acknowledgment of any interrupts is 
actually delayed until after the completion of the 
instruction following the interrupt enable. 
Here's the interrupt service routine itself : 



7F14 F3 






DI 






Interrupts off 


7F15 


F5 






PUSH 


AF 




All of these 


7F16 


E5 






PUSH 


HL 




regi sters 


7F17 


D5 






PUSH 


0E 




will be used 


7F18 


C5 






PUSH 


BC 




to do thia 


7F19 


3A 


EC 


37 


LD 


A,(37ECH) 


Read disc chip 


7F1C 


3A 


EO 


37 


LD 


A,(37E0H) 


Reset clock F/F 


7F1F 


B1 


11 


01 


LD 


HL 


0111H 


Message start 


7F22 


11 


as 


3C 


LD 


DE 


3C25H 


Display space 


7F25 


01 


1A 


00 


LD 


BC 


001 AH 


Mesaage Length 


7F28 


ED 


B0 




LOIR 






DiapLay It 


7F2A 


C1 






POP 


BC 




Put all these 


7F2B 


01 






POP 


0E 




regi sters 


7F2C 


E1 






POP 


HL 




, back in 


7F2D 


F1 






POP 


AF 




; plBce 


7F2E 


FB 






EI 






•Interrupts on 


7F2F 


C9 






RET 






Return whence 



The instructions loading the accumulator 
from 37EC and 37E0 accommodate the quirks of 
the TRS-80 hardware — the Z-80's interrupt 
acknowledge signal is not used in this hardware 
scheme. Instead, reading 37EC (disk controller 
status) followed by reading 37E0 (real-time 
clock) resets a flip-flop used to signal input from 
disk controller and real-time clock, respectively. 
This must be done each time or the interrupt 
will continue to be 'on', forcing the routine ever 
back upon itself. 

You may protect memory at 32512 if you wish, 
as this will prevent any accidental crashes while 
you're trying this demo program. Also note that 
if you have installed a disk-disable switch on 
your interface, this program may initially lock 
up. The lockup may be cured by momentarily 
flipping the disable switch on then off. 

So what's the point of this? Only to show that 
no matter what BASIC (or machine language) 
program you are operating, including DOS, the 
sign-on message will remain in the upper-right 
corner of the screen. CLS, scrolling, even 
attempting to overwrite the area with text will 
have no apparent effect, because the interrupt 
takes priority. To disable it, put a RETurn 
instruction in place - 



POKE 16402,201 

and to enable it, replace the return with a 
JUMP: 

POKE 16402,195 

Under DOS, the usual CMD"R" and 
CMD"T" instructions will have their intended 
effect. Re-initializing Level II BASIC or DOS 
from 0000 will wipe out the interrupt patch to 
7F14. 

On to Something Useful 

There are a few rules of thumb for using 
interrupts. First, the interrogation and service 
routines must be as short as possible, or else the 
main program will get little work done between 
interrupts. This means, alas, very few calls to 
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ROM; the ROM calls, although effective, often 
contain a level of detail and error-checking that 
may be beyond the absolute minimum needs of 
the service routine. 

Second, every register to be used by the 
service routine must be preserved, usually on the 
stack, since there is no way of knowing which 
registers will be in action when an interrupt 
occurs. The only safe bet for ordinary BASIC 
programs using Level II alone is to alternate 
register pairs (by executing EX AF.AF' and 
EXX), since the alternates are not used in Level 
II. IX, however, must still be saved. 

With these thoughts in mind, have a look at the 
listing below, which prints a more useful message 
onto the screen: the BASIC memory available at 
all times. 
Listing 5-3. Free memory constant display. 
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7F0Q F3 




SETUP 


DI 






7F01A3E C3 






LB 


A.0C3H ; 




7F03 32 12 


40 




L0 


I4Q12H),A i 


Setup 


7F06 21 14 


7F 




LD 


HL, SERVE 


routi ne 


7F09 22 13 


40 




LD 


(4013H),HL 


simi Ler 


7FDC 21 19 


1A 




LD 


HL.1A1SH 


to that 


7FDF E5 






PUSH 


HL 


presented 


7F10 ED 56 






IM 


1 


above 


7F12 F8 






EI 






7F13 C9 






RET 






3CD0 




VIDEO 


EO0 


3CD0H 




40 EB 




STKB0T 


EQO 


40E8H 




40FB 




ARRTOP 


EOJJ 


40FBH 




7F14 F3 




SERVE 


DI 




No interrupt 


7F15 F5 






PUSH 


AF 




7F16 E5 






PUSH 


HL 




7F17 D5 






PUSH 


DE 


Save aU 


7F18 C5 






PUSH 


BC 


' registers to 


7F19 DD E5 






PUSH 


IX 


be used 


7F1B FD E5 






PUSH 


IY 




7F1D 3A EC 


37 




LD 


A,(37ECH) 


; Clear FDC 


7F20 3A EG 


37 




LD 


A,(37E0H) 


i Clear F-F 


7F23 21 69 


7F 




LD 


HL, MESSG 


; Gat "MEM=" 


7F26 11 36 


3C 




LD 


DE.VIDE0+36H 


; Place to go 


7F29 01 05 


00 




LD 


BC,5 


Its length 


7F2C ED BO 






LDIR 




; Display it 


7F2E AF 






XOR 


A 


Clear carry 


7F2F 2A EB 


40 




LD 


HL,(STKB0T) 


BASIC stack 


7F32 ED 5B 


FB 


40 


LD 


DE, (ARRTOP) 


; Array area 


7F36 ED 52 






SBC 


HL.OE 


; Room left 


7F38 DD 21 


3B 


3C 


LD 


IX.VI0E0+3BH 


, Place to go 


7F3C FD 21 


6E 


7F 


LD 


IY, TENTAB 


; Tens-table 


7F40 06 05 






LO 


B,5 


; No. digits 


7F42 AF 




L00P0 


XOR 


A 


; Clear carry 


7F43 FD 5E 


00 




LD 


E.1IY+0) 


; 10000 lobyte 


7F46 FD 56 


01 




LD 


D,(IY+1) 


; 10000 hibyte 


7F49 B7 




LOOP1 


OR 


A 


, Set flag 


7F4A ED 52 






SBC 


HL.DE 


; 1st diffnce. 


7F4C 38 03 






JR 


C.JUMPO 


If greater 


7F4E 3C 






INC 


A 


; Additive div 


7F4F 18 FB 






JR 


L00P1 


; Divide again 


7F51 19 




JUMP0 


ADD 


HL.DE 


; Was too much 


7F52 C6 30 






ADD 


A,30H 


; ASCII cnvrt. 


7F54 DD 77 


DD 




LO 


[IX+0),A 


Display it 


7F57 DD 23 






INC 


IX 


Next screen 


7F59 FD 23 






INC 


IY 


Move once, 


7F5B FD 23 






INC 


IY 


end egain 


7F5D 10 E3 






OJNZ 


L0OP0 


Do 5 digits 


7F5F FD E1 






POP 


IY 




7F61 DD E1 






POP 


IX 


Restore all 


7F63 CI 






POP 


BC 


the rag's 


7F64 D1 






POP 


DE 


used to do 


7F65 E1 






POP 


HL 


the work 


7F66 F1 






POP 


AF 




7F67 FB 






EI 




Ints. okay 


TFSB C9 






RET 




BASIC a»aits 


7F69 8F 




MESSG 


DEFB 


BFH 


Block 


7F6A 






DEFM 


'MEMs' 




7F6A 4D 


7F6B 45 


7F6C 


4D 7F6D 3D 




7F6E 10 27 




TENTAB 


DEFW 


1000DD 


Tene-table 


7F70 E8 03 






DEFW 


01000D 


is used for 


7F72 64 00 






DEFW 


001 ODD 


division by 


7F74 0A 00 






DEFW 


0001 OD 


subtraction 


7F76 01 00 






DEFW 


00001 D 




7F00 






END 


SETUP 
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The 19-byte interrupt setup routine is found 
as usual, followed by the 100-byte service 
subroutine. All registers are saved — IY is 

optional but may be used by other utilities — a 
message is displayed, and a calculation is made 
to determine free memory. This calculation is 
the bottom of the BASIC subroutine stack 
(referenced at 40E8) minus the top of array 
space (referenced at 40FB). 

Following that is a short, five-digit binary-to- 
ASCII table lookup which, in 35 bytes, converts 
and displays the free memory. 

This routine is especially useful because it can 
help identify the actual area causing out-of- 
memory errors at run time. Heavily nested 
calculations can push the BASIC stack well 
down into memory, which is then visible on the 
screen. Put the program in place, and then try 
this : 

10 GOSUB 20 
20 GOTO 10 

Something Even More Useful 

If you by chance have a printer which prints 
less than 40 characters per second, the following 
routine will speed up your BASIC programs. 
Otherwise, this routine will have little effect on 
your program speed (perhaps a two or three 
percent slowdown), but will allow a program to 
continue without 'locking up' while the printer is 
in action. It is called a 'spooler', a word which is 
based on an acronym mercifully forgotten. 

When an LPRINT or LLIST is commanded, 
the spooler sends the characters to an in-memory 
buffer, and returns to the waiting program. Since 
255 characters is the maximum string length, this 
buffer size is adequate; increasing it will be 
valuable only if the main program is highly 
interactive, involving user, screen, calculations 
and printer. 

Normally, the LPRINT and LLIST routines 
send a character to the printer, and then check to 
see if the printer is 'busy'. In the meantime, the 
line printer routine is idle, performing no other 
work, and ignoring the BASIC program. Those of 
you with Teletypes know the discouraging 
feeling of waiting for hard copy. 

Instead of waiting for the printer to output the 
entire number, word, or line before returning to 
the program, an interrupt service routine is used 
as a 'despooler'. When the 25-mS interrupt is 
generated, the despooler checks the 255-byte 
buffer to see if a printable character is present. If 
there is, the routine sends that character to the 
printer, advances the buffer, and returns to the 
program in progress. Also, if the printer is busy, 
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Listing 5-4. Print spooler. 

ucnuu ; MHn nmt tnmuu*Ht§**um**tuit§t*u*t*tuHt 

00110 ; THIS INTERRUPT SERVICE ROUTINES STORES UP TO 255 CHAR- 

00120 ; ACTERS IN A BUFFER, WHERE THEY MAY THEN BE OUTPUT TO 

00130 ; A PRINTER. THIS SPOOLER CHECKS FOR CHARACTERS AT THE 

00140 ; PRINTER DRIVER ROUTINE, INTERCEPTS THEM, STASHES THEM, 

00150 J AND RETURNS TO THE MAIN PROGRAM WITHOUT DELAY. 





001B0 


; iiHiuinmittntitHiHmiimiitttuiifriittitiiii 




00170 










7E00 


00180 
00190 


i 


ORG 


7E00H 






00200 


; mmtiitiiimiittnutttntimiiiitiiiitiitmitin 




00210 


i SETUP ROUTINE 


CREATES A BUFFER 


AND PLACES ITS ADDRESS, 




00220 


; ALONG 


WITH A 


JUMP TO REPLACE THE NORMAL RET. AT 401 2H 




00230 


; mmiiimtitiiittimttmnmiiunttiiiiiumiu ' 




00240 


; 








7E00 F3 


00250 


SETUP 


DI 




; INT. OFF DURING SETUP 


7E01 3EC3 


002B0 




LD 


A.0C3H 


; GET JUMP VALUE INTO A 


7E03 321240 


00270 




LO 


[4012HJ.A 


; PLACE INTO INT. VECTOR 


7E06 AF 


00280 




XOH 


A 


; CLEAR ACCUMULATOR 


7E07 47 


00290 




LD 


8, A 


; PUT 100 HEX INTO B 


7E08 21BA7E 


00300 




LD 


HL.BUFFER-1 


; HL JUST AHEAD OF BUFFER 


7E0B 23 


00310 


CLEAR 


INC 


HL 


; NEXT POSITION IN BUFFER 


7E0C 77 


00320 




LD 


(HL),A 


; PLACE ZERO INTO BUFFER 


7EOD 10FC 


00330 




DJNZ 


CLEAR 


j DO IT FULL 256 TIMES 


7EOF 213F7E 


00340 




LO 


HL, SERVE 


; GET SERVICE ROUT. ADDR. 


7E12 221340 


00350 




LO 


[4013H),HL 


; PLACE INTO INT. VECTOR 


7E15 21237E 


00360 




LD 


HL, SPOOL 


; GET SPOOL ROUTINE 


7E18 2226 40 


00370 




LD 


[4026HJ.HL 


; PLACE IN PRINTER DRIVER 


7E1B 21191A 


00380 




LO 


HL.1A19H 


; RETURN TO BASIC INTO HL 


7E1E E5 


00390 




PUSH 


HL 


j PLACE ON STACK 


7E1F ED56 


00400 




IM 


1 


; SET INTERHUPT MODE 


7E21 FB 


00410 




EI 




; INTERRUPTS READY TO GO 


7E22 C9 


00420 
00430 




RET 




; BACK TO BASIC READY 




00440 


; iittiititttniHintttuititntitntttimittntinifH 




00450 


; SPOOL 


ROUTINE STARTS HERE AND 


INTERCEPTS PRINTER DRIVER 




00460 


; iummmmtituttiitttutimtttttnttnttntttttt 




00470 


; 








7E23 F3 


00480 


SPOOL 


01 




; INT. OFF DURING SPOOL 


7E24 E5 


00490 




PUSH 


HL 


; SAVE HL REGISTER 


7E25 7B 


00500 




LO 


A,C 


; GET CHARACTER INTO A 


7E26 F5 


00510 




PUSH 


AF 


j SAVE CHAR. TO PRINT 


7E27 21BC7E 


00520 




LO 


HL.BUFFER+1 


; POINT TO BUFFER START 


7E2A FB 


00530 




EI 




; INTERRUPTS BACK ON NOW 


7E2B 7E 


00540 


LOOPS 


LD 


A,(HL) 


; GET BUFFER VALUE 


7E2C A7 


00550 




AND 


A 


j IS IT A CHAR. OR ZERO? 


7E20 20FC 


005B0 




JR 


NZ.L00P2 


; WAIT IN LOOP IF FULL 


7E2F F3 


00570 




01 




; INTERRUPTS BACK OFF 


7E30 06FD 


00580 




LD 


B.OFDH 


; GET PRESENT BUFFER SIZE 


7E32 23 


00580 


LOOPS 


INC 


HL 


; GET NEXT BUFFER POS'N 


7E33 7E 


00600 




LD 


A.IHLJ 


; BRING VALUE INTO A 


7E34 A7 


00610 




AND 


A 


; TEST FOR CHAR. OR ZERO 


7E35 2002 


00620 




JR 


NZ, SAVEIT 


j FOUND FREE SPACE - GO 


7E37 10F8 


00830 




DJNZ 


L00P3 


; SEARCH THROUGH BUFFER 


7E39 2B 


00640 


SAVEIT 


DEC 


HL 


i BACK OFF ONE POSITION 


7E3A F1 


00650 




POP 


AF 


; RESTORE CHAR. TO PRINT 


7E3B 77 


00660 




LD 


(HLJ.A 


; PUT IT IN BUFFER 


7E3C E1 


00670 




POP 


HL 


; RESTORE FORMER VALUE 


7E3D FB 


006 BO 




EI 




; INTERRUPTS BACK ON 


7E3E C9 


00690 
00700 




RET 




; BACK TO MAIN ROUTINE 




00710 


; miftmiitnmttniiiitttntitntimtitntntniiit 




00720 


; INTERRUPT SERVICE ROUTINE FIRST SAVES REGISTERS, THEN 




00730 


i RESETS INTERRUPT FLIP-fLOPS IN 


E/I. PRINTER STATUS 




00740 


j IS EXAMINED, 


AND THE ROUTINE EXITED IF PRINTER BUSY. 




00750 


; #####*##*#f#####»###t#«####*f ####*#«( *####**##»#####*># 




00760 


; 








7E3F F3 


0077D 


SERVE 


DI 




i INT. OFF DURING DESPOOL 


7E40 F5 


00780 




PUSH 


AF 


; SAVE VALUE IN ACCUM. 


7E41 E5 


00790 




PUSH 


HL 


; SAVE VALUE IN HL 


7E42 D5 


00800 




PUSH 


OE 


; SAVE VALUE IN DE 


7E43 C5 


O0B10 




PUSH 


BC 


; SAVE VALUE IN BC 


7E44 D0E5 


00820 




PUSH 


IX 


; SAVE VALUE IN IX 


7E46 DD212540 00830 




LO 


IX.4025H 


; PRINTER CONTROL BLOCK 


7E4A 3AEC37 


00840 




LO 


A,(37ECH) 


; RESET INT. FLIP-FLOP 


7E4D 3AE037 


00850 




LO 


A,[37E0H) 


; RESET INT. FLIP-FLOP 


7E50 3AEB37 


00860 




LD 


A.I37E8H) 


; GET PRINTER STATUS TO A 


7E53 E6F0 


00870 




AND 


OF OH 


; MASK OUT LOW BITS 


7E55 FE3C 


00880 




CP 


30H 


; SEE IF PRINTER IS BUSY 


7E57 205A 


00880 
00800 




JR 


NZ.OUT 


; GO OUT IF PRINTER BUSY 




00910 


; illiniilttlllllultllllttllllHtlllllllimilttlllllit 




00920 


; WHEN 


PRINTER 


IS READY, BUFFER 


IS MOVED UP, THE CHAR- 




00830 


; ACTEF 


IS TESTED, AND PRINTED IF A VALID CHARACTER. 




00940 


; IF IT 


IS CARRIAGE RETURN, FORM 


FEED, LINE FEED, ETC., 




00950 


; APPROPRIATE TESTS ARE MADE IN 


THE PRINTER CONTROL BLOCK 




00960 


; iiiHiiiiitminntmiiitiHiiHtittitmmmtntit 




00970 


; 








7E58 21B97F 


009B0 




LO 


HL.BUFFER+OFEH 


; GET NEXT TO LAST CHAR. 


7E5C 11BA7F 


00980 




LD 


DE.BUFFER+OFFH 


; GET NEXT CHAR. IN QUEUE 


7E5F 01FF00 


01000 




LD 


BC.OFFH 


i GET TOTAL BUFFER SIZE 


7E62 EDB8 


01010 




LODR 




; MOVE IT UP ONE POS'N 

Listing Continued 



it returns to the program immediately. 

A ten-character-per-second (cps) printer like a 
Teletype is 'busy' for 100,000 microseconds for 
each character. In that time, a BASIC program 
might perform many calculations. Selectrics 
type a maximum of 15 cps, which is also time- 
consuming. 

The program will not necessarily benefit in 
time with faster printers, but the waiting period 
will be eliminated in favor of a more interactive 
program overall. 

The following listing is uncommented, as the 
bulk of the interrupt explanations have already 
been presented. The spooler is entered from 
BASIC via LLIST and LPRINT, either of which 
moves directly to the printer driver address 
referenced at 4026 and 4027. This is replaced with 
the address of the spooler. The character to be 
printed is delivered to the printer driver in the C 
register. The spooler searches through the buffer 
for the first non-zero value and places the 
character to be printed immediately before that. 
(If your system requires nulls after a carriage 
return, you can back up the appropriate number 
of places in the buffer). 

Upon interrupt, the despooler saves registers 
and loads the IX register with 4025, the start of 
the printer device control block. This block 
contains line and page information, which is used 
to determine if paging has been completed, and 
how line feeds, carriage returns, and form feeds 
will be handled. It is functionally identical to the 
driver in ROM, except that it takes its characters 
from the spooler's buffer instead of directly from 
the Level II routines. 

If the printer is not busy, then, the character is 
sent to the printer address at 37E8. Following is 
the complete routine, including setup, spool, and 
despool. 

All of the interrupt programs presented in this 
article depend on the expansion interface for 
their 25 mS clock pulses. However, a simple 
rectified and shaped 16.66 mS pulse, which will 
work fine with all of these routines, can be 
created using the 60 Hz output of a 6.3-volt, low- 
current filament transformer, resistor, and 7414 
Schmitt trigger. 

The complete circuit for a printer decoder is 
available from Radio Shack as 'Printer Cable 
Service Manual'. 
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Continued Listing 



7E64 3ABA7F 
7E67 A7 

7E66 2849 
7EBA FEOB 
7E6C 280A 
7E6E FEOC 
7E7D 201F 
7E72 AF 
7E73 0DB603 
7E7B 281 9 
7E78 DD7E03 
7E7B DD9604 
7E7E 47 
7E7F 3AE837 
7EB2 E6FD 
7EB4 FE30 
7E86 2DF7 
7E88 3E0A 
7E8A 32E837 
7EBD 1OF0 
7EBF 181E 
7E91 47 
7ES2 3AE837 
7ES5 E6F0 
7E97 FE30 
7E99 20F7 
7E9B 78 
7E9C 32E837 
7E9F FEOD 
7EA1 2010 
7EA3 0D3404 
7EA6 DD7E04 
7EA9 DDBE03 
7EAC 79 
7EAD 2004 



01020 

01030 

01040 

01050 

01060 

01070 

□1080 

01090 

01100 

01110 

01120 TEST1 

01130 

01140 

01150 LOOPA 

01160 

01170 

01180 

01190 

01200 

01210 

01220 

01230 TEST2 

01240 LOOPS 

01250 

01260 

01270 

01280 

01290 

01300 

01310 

01320 

01330 

01340 

01350 

01 360 



7EAF DD3B0400 01370 EXIT 
01380 ; 



LO 

AND 

JR 

CP 

JR 

CP 

JR 

XOR 

OR 

JR 

LD 

SUB 

LD 

LD 

AND 

CP 

JR 

LD 

LO 

DJNZ 

JR 

LD 

LD 

AND 

CP 

JR 

LD 

LD 

CP 

JR 

INC 

LD 

CP 

LD 

JR 

LD 



A,(BUFFER+OFFH) 

A 

Z.OUT 

OBH 

Z.TEST1 

OCH 

NZ.TEST2 

A 

(IX+3) 

Z.TEST2 

A, (IX+3) 

IIX+4J 

B,A 

A,137E8H) 

OFOH 

30H 

NZ , LOOPA 

A.OAH 

(37E8H),A 

LOOPA 

EXIT 

8, A 

A.137E8H) 

OFOH 

30H 

NZ, L00P6 

A,B 

(37E8HJ ,A 

ODH 

NZ.OUT 

I IX+4) 
A, (IX+4) 

(IX+3) 

A,C 

NZ.OUT 

(IX+4),0 



GET QUEUE CHAR TO PRINT 
TEST TO SEE IF ZERO 
GO OUT IF NONE LEFT 
CHECK IF TOP OF FORM 
TEST IF CHAR. IS ONE 
TEST IF CHAR = F.F. 
NEXT TEST IF NOT 
CLEAR ACCUMULATOR 
GET LINES PRINTED 
OUT IF VALUE = 
GET LINES PRINTED 
GET LINES PER PAGE 
PUT LINES LEFT IN B 
GET PRINTER STATUS 
MASK OUT LOW BITS 
CHECK STATUS BITS 
LOOP IF PRINTER BUSY 
GET LINE FEED CHAR. 
SEND IT TO PRINTER 
DO IT TILL FORM IS FED 
60 OUT WHEN DONE 
STASH CHAR. IN B REG. 
GET PRINTER STATUS 
MASK OUT LOW BITS 
CHECK STATUS BITS 
LOOP TILL PRINTER READY 
GET CHAR. BACK INTO A 
SEND IT TO PRINTER 
CHECK IF CARRIAGE RET. 
IF NOT THEN GO OUT 
ELSE INC. LINES COUNTER 
GET NEW LINES COUNTER 
CHECK WITH LINES/PAGE 
GET CHARACTER BACK TO A 
GO IF NOT PAGE END 
RESET PAGE LINES TO 



7EB3 DDE1 
7EB5 C1 
7EB6 D1 
7EB7 E1 
7EB8 F1 
7EB9 FB 
7EBA C9 
OOFF 
7FBA 00 



01390 

01400 

01410 

0142D 

01430 ; 

01440 OUT 

01450 

01460 

01470 

01480 

01490 

01500 

01510 BUFFER 

01520 

01530 ; 

01540 

01550 



(t lift It itl tilt ttUtttHltt^HlltttttllltUlltlimnn 

REGISTERS ARE RESTORED AND THE ROUTINE IS EXISTED. THE 
LAST 255 BYTES OF SPACE AHE RESERVED FOR PRINTER BUFFER 



POP 

PUP 

POP 

POP 

POP 

EI 

RET 

DEFS 

DEFB 



IX 
BC 
DE 
HL 
AF 



255 

DO 



RESTORE IX REGISTER 
RESTORE BC REGISTER 
RESTORE DE REGISTER 
RESTORE HL REGISTER 
RESTORE AF REGISTER 
INTERRUPTS BACK ON 
BACK TO MAIN ROUTINE 
DEFINE 255-CHAR. BUFFER 
END BUFFER WITH BYTE 



END SETUP 



00000 TOTAL ERRORS 

29420 TEXT AREA BYTES LEFT 



BUFFER 


7EBB 


01510 


00300 


00520 00980 00990 01 020 


CLEAR 


7E0B 


00310 


00330 




EXIT 


7EAF 


01370 


01220 




L00P2 


7E2B 


00540 


00560 




L00P3 


7E32 


00590 


00630 




LOOPA 


7E7F 


01150 


01180 


01210 


LOOPB 


7E92 


01240 


01270 




OUT 


7EB3 


01440 


00890 


01040 01310 01360 


SAVEIT 


7E39 


00640 


00620 




SERVE 


7E3F 


00770 


00340 




SETUP 


7E00 


00250 


01550 




SPOOL 


7E23 


00480 


00360 




TEST1 


7E7B 


01120 


01060 




TEST2 


7E91 


01230 


01080 


01110 
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More Hardware Modifications 

By now your TRS-80 is an electronic in- 
timate. In this chapter, some significant (and 
some sophisticated) hardware modifications will 
be made. A few of these are simple, and their 
value is not immediately obvious. Others 
involve major work (such as the high-resolution 
graphics), but the results are exciting and very 
rewarding. 

Making Halt Work 

Let's start with an easy one. The HALT 
instruction is a useful command. It isn't 
exceptional, but you will find that time spent 
idling in loops waiting for an interrupt is easier 
when the HALT instruction is used. In fact, its 
main advantage comes when the Z-80 
microprocessor is used in interrupt-based 
systems. Where program work is being done, the 
HALT instruction is not particularly 
meaningful; but where program operations are 
suspended except for interrupts, it is very useful. 



When HALT is executed on the Z-80, the 
processor simply ceases program counter 
operation and executes NOPs in order to 
continue memory refresh. That is, the Z-80 
outputs a fetch (the Ml or machine cycle one 
signal) which - together with a refresh address on 
the address bus - constitutes enough information 
to keep the memory active. The information 
received during the fetch is ignored by the CPU, 
which continues to execute NOPs until an 



interrupt is received. It then exits the NOP state 
and services the interrupt. 

Whenever the HALT instruction is executed, 
a halt-acknowledge signal (HALT, active low) is 
output on pin 18. In the TRS-80, pin 18 is tied to 
an input of NAND gate Z53. The other input of 
Z53 is tied high through a 10K resistor, but can 
be pulled low when the Reset button is pressed. 
In other words, either a Reset or a HALT will 
redirect the CPU to the address of the non- 
maskable interrupt (NMI), where it will 
continue execution from either 'READY' or DOS 
reboot. 

By cutting loose pin 18 of the CPU (Z40), and 
tying Z53 pin 2 high, with a 4.7K ohm resistor, the 
HALT instruction will operate as intended by 
the Z-80's designers. Memory will continue to be 
refreshed, as the 4116s' refresh cycle depends on 
RAS (row address strobe), which will be output 
as usual by Z72. 

Cut the trace running from Z40, pin 18. Attach 
a 4.7K ohm resistor from Z53 pin 2, to Z53 pin 14. 
The modification is complete. 

A Real Break 

Later in this Chapter is a power-on monitor, 
which will give more importance to the minor 
change described here. The TRS-80 does not 
have a true 'break' function that resets the CPU 
to its power-up condition. It can be simulated 
by entering SYSTEM followed by /0, or by 
pressing the Reset button on a disk system. 
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This change is quite simple. Locate Z53, a 
74LS132 NAND gate, which feeds (through Z52) 
the system reset pin of the Z-80 microprocessor. 
When the power is turned on, capacitor C42 
takes time to charge, holding the processor in its 
reset mode for a few milliseconds. When the 
capacitor charges completely, the input to Z53 is 
held high by resistor R47. 

Run a wire from pins 12 and 13 of Z53, through 
a IK resistor, to one end of a SPST (single pole 
single throw) normally open pushbutton switch. 
The other end of the switch goes to ground 
(which can be found at Z53, pin 7). When this 
switch is pressed, the Z53 sees a low signal, and 
resets the processor to address 0000. A resistor is 
used in series so that C42 is not overexerted by 
shorting directly to ground. 

Be sure to mount this button well out of the 
way; for disk systems, it's as fatal as the Reset 
button. For Level II it means MEMORY SIZE? 
and the loss of any program in memory. 

Stuck Relays 

There are two ways to fix a stuck relay: bang it 
until it unstucks, or replace it. The many 
published fixes to tape recorders, or additional 
external circuitry, simply don't take into 
consideration any changes you might make to 
your tape system; nor to the possibility you may 
take your CPU with you when you work 
elsewhere. 

A replacement relay is available from Lab 
Service, Inc., Box 383, Hustisford, Wisconsin 
53034. Unlike the relay normally installed in the 
TRS-80, it is reliable, low power and has gold 
contacts. I have installed this unit in my 
computer, and run the high current motor of a 
CTR-41 through 100,000 operations 
continuously over the course of a week. Neither 
the CTR-41 nor the relay failed. 

The cassette relay is mounted just behind the 
jacks for power, video and cassette. It is a 
cylinder approximately the size of the LSI 
replacement relay, but in most TRS-80s it 
contains six leads instead of four. 

Using solder-wick and a hot soldering iron, 
heat the solder connections and draw off excess 
solder. While doing this, slide a thin flat blade 

under the relay. Take care not to move the 
nearby small video trimmer potentiometers. Use 
the blade as a lever, lifting the old relay off the 
board. Apply very gentle pressure to this lever, 
and alternately melt the three solder connections 
on each side of the relay. Do not use force that 



might crack the board or lift solder traces from 
the board. 
When one side of the relay is completely free, 

grasp it with your hand and pull gently, while 
heating the remaining three connections on the 
opposite side of the relay. It will eventually pull 
free. 

Remove excess solder from the holes with the 
solder-wick. Use a fine splinter to open the eyes 
of the holes, if all the solder does not flow into the 
solder-wick. 

Now examine the circuit board, noting that on 
the end of the relay position nearest the 
computer's connection jacks there are two 
otherwise unused connections; no circuit traces 
run out from these points. Look at the 
relacement relay, noting that it has four wires, 
three on one side and one on the other. Orient it 
above the board 90 that the unused holes match 
the end of the relay with the single wire. This 
wire feeds into the center of the trio of holes. 

Carefully insert the relay in place; if you have 
properly cleaned out the connection holes, the 
new relay wires will slide in, barely protruding 
from the opposite side of the board. You may 
have to bend them just a bit in order to get them 
to feed through. 

Once the wires are in place, apply a very small 
amount of solder, and secure the relay on the 
board. Check carefully for solder splashes, shorts 
or cracks, and clean or repair them. Such a check 
is doubly important here because the relay driver 
circuit (unlike most other circuits in the TRS-80) 
cannot handle a short circuit for very long. 

Refit the boards and covers of the computer 
together, replace the power and cassette cables; 
then put the cassette player into its play position, 
and enter this program: 



10 PRINT#-1," " 

20 FOR N = 1 TO 500 : NEXT 

30 GOTO 10 



This program will turn the cassette player on 

and off at regular intervals. If it does not work 
properly, double check all connections, 
especially the orientation of the relay, and try 
again. This fix should eliminate any further 
concern over a sticking relay causing skipped 
data or missed program loads. 
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High Resolution Graphics 

Now for the biggie. In the past few years, 
there has been quite a bit of excitement 
generated by the idea of high-resolution 
graphics. Reasonably representative images can 
be drawn with them, and animation is 
considerably more exciting; especially when 
compared with the extremely high resolution of 
the type used in the latest generation of coin- 
operated video games. The Apple computer was 
advertised with a heavy emphasis on their high 
resolution, hard as it is to work with. The new 
Radio Shack Color Computer also offers several 
modes of resolution. 

The following project can either stand alone as 
a plug-in peripheral, or be integrated as part of 
the TRS-80 keyboard unit. In either case, the 
specifications are: 

1. Resolution of 384 dots wide by 192 dots 
deep. 

2. Full compatability with all current 
software. 

3. Simultaneous use and overprint of 
normal TRS-80 alphanumerics and 
graphics. 

4. Addressing using six bits in contiguous 
memory blocks of 768 bytes each; sixteen 
total memory blocks are used. 

The hardware involved in this project, 
including power supply and miscellaneous 
hardware, will be under $100 (probably closer to 
$70 by the time you read this), yet will compete 
easily with any high-resolution add-on for the 
TRS-80. 

On the negative side, this project will involve 
a great deal of wire wrapping or soldering, and 
will eat up one chunk of 16K memory address 
space when it is used. It will not actually 
compete with or replace the top memory block in 
the expansion box (there is no electronic 
conflict) but will be addressed from COOO 
to FFFF. Alternatively, it may be addressed 
from 8000 to BFFF. In either case, you 
do not need the expansion box to run this 
memory. 



The TRS-80 screen has 1,024 locations in a 
grid of 64 characters across by 16 lines down. 
Within each of these grid elements are blocks 2 



pixels by 3 pixels (a pixel is a 'picture element') 
for the familiar coarse graphics mode accessed 
with SET and RESET. If you turn the contrast 
fully down and reduce the brightness of the 
screen, the individual dots which make up the 
graphic and alphanumeric characters can be seen 
with a sharp eye; a magnifying glass will make the 
dots very clear. 

In order to produce a complete screen line of 
letters, the locations in video memory are handed 
to a circuit which actually accesses them twelve 
times - once for each pass the electron beam 
makes horizontally. At each pass, a row of dots 
corresponding to part of the whole line of letters 
is shifted out to the video beam. Each dot (or 
'undot') then turns the beam on or off for the tiny 
fraction of a second it takes to sweep across 
1 /384th of the screen. 

The point is clear: an electronic event takes 
place for every dot on every line of the screen. 
This means that it is possible to create an 
individual, addressable electronic event for each 
screen dot. 

The process might work like this: 

1. Devise a circuit whose timing 
characteristics are identical to the video 
timing of the usual TRS-80 circuits. 

2. Instead of addressing the same video 
memory on twelve consecutive screen lines, 
have the addressing select different memory 
for each line. 

3. Have the contents of that memory filled 
by the TRS-80, and displayed on the same or 
a different monitor. The add-on has its own 
video circuitry, but can be displayed on the 
same monitor because step 1 specifies that 
the timing characteristics must be identical 
to those in the TRS-80. It's like an auto 
with 4-wheel drive, where all wheels are 
capable of working together; or a 
dual-capstan tape recorder, where both 
capstans pull the tape to ensure steady 
contact with the playback head. 



The circuit shown opposite presents the 
complete high-resolution circuitry. There are 
two ways of building this circuit since the areas 
shaded in grey are already present within the 
TRS-80. If you wish, you can solder directly to 
those circuits inside the computer, saving 
yourself some parts and perhaps a bit of time. 
Otherwise, the entire circuit can be built 
separately. 
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Figure 6-1. Complete high resolution circuit 
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Figure 6-1 b. High resolution memory. 
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Figure 6- 2 c. Hig/i resolution power supply. 
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Figure 6-2. Hires clock circuit 

Figure 6-2 is the clock. The 10.6445 MHz 
crystal is the same one used in the TRS-80; 
Radio Shack sells it for $3.95, on special order. 
A small trimmer capacitor is included so that 
the frequency of the high resolution board can be 
aligned identically to that in the computer. 

Figure 6-3 is the master video countdown 
chain and timing circuitry, also nearly identical 
to that inside the TRS-80. There are a few 
exceptions. The logic necessary for 32 characters 
per line is not present (it is not needed in high 
resolution mode, although the normal 
alphanumerics may be displayed in 32-character 
mode simultaneously with the hi-res graphics 
screen). Also, the four outputs of Z6 do not feed 
any latches or character generators; instead, 
they become the line of dots addresses for high 
resolution memory. Identical (top and side) 
screen blanking is used. 

Figure 6-1. is the high-resolution memory 
itself. The familiar 4116 type, 16K dynamic 
memories are used in this circuit (250 nS or less 
is essential), but with a difference. The hi-res 
board must generate its own memory refresh, yet 
hand over control to the TRS-80 when it needs to 
select memory into which it will write 
information. Thus, Z20 multiplexes the on- 
board refresh/select (MRAS, MCAS, MMUX) 
with the TRS-80 select (CRAS, CCAS, CMUX). 

The switch is made by the simultaneous 
presence of addresses 14 and 15 on the address 
bus. 



On-board refresh/select is generated by the 
clock in combination with two flip-flops (Z3a/b), 
producing select in this order: 

1. Z2 pin 8, selects the lowest portion of the 
address; as such, it is the fastest changing 
memory select signal. 

2. Two clock cycles later, Z2 pin 11, 
produces a signal which will be gated by Z9 
and inverted to produce MRAS (row address 
strobe). 

3. One clock cycle later, MMUX goes high, 
produced by the clocking of Z3a. 

4. One clock cycle later, MRAS is continued 
as Z2 pin 11 goes low by Z2 pin 9 going high. 
The transition is simultaneous and virtually 
invisible. 

5. At that time, MCAS is produced when 
Z3b is clocked low at the NOT Q output. 

6. Memory data is stable at this time, and 
two clock cycles later, LATCH is issued by 
Zle, latching the data into Z16 for its trip 
through shift register Z17. 

Figure 6-3 shows the creation of horizontal 
and vertical synchronization signals, and the 
horizontal and vertical screen positioning 
controls. This circuitry again is identical to that 
in the TRS-80, as is Figure 6-4 , the video 
mixing circuitry. 

There is only one critical construction area in 
the device, and that is the circuitry surrounding 
the 10.6445 MHz crystal (Z16, R4-5, Cl). The 
wires in this area must be very short, and all the 
parts clustered together. Capacitor Cl should be 
the only part of the circuit responsible for tuning 
the crystal's frequency, not random capacitance 
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Figure 6-4. The video mixing circuitry. 

introduced by a haphazard bunch of wires. 

Other than the wire layout near the crystal, 
construction is time-consuming but 
straightforward. I recommend wire wrapping 
the entire circuit; use different colors for data, 
address, video, ground, etc., so that 
troubleshooting will be simplified. 

The completed circuit will have these external 
controls: 

1. Power. Three voltages, +5, -5, and +2 
are necessary. -5 volts must be present first 
and last. 

2. Mixing. This controls the intensity of 
the high-resolution board with respect to 
the TRS-80 alphanumerics and graphics. 

3. Fine tuning. This adjusts the 
frequency of the 10.6445 MHz crystal to 
that of the TRS-80. Occasional 
adjustments will be necessary with 
temperature changes. 

4. Vertical and horizontal positioning. 

These control the placement of the image 
on the screen; it should coincide with the 
alphanumeric screen normally produced 
by the TRS-80. 

5. Input. This accepts a cable running 
from the TRS-80 video jack, which would 
normally attach to the video monitor. 

6. Output. This accepts a cable from the 
video monitor, and provides an output 
which mixes the TRS-80 alphanumerics 



and graphics with the high-resolution dots. 

To use the device, attach a 5-pin DIN cable 
between the TRS-80 video jack and the input 
jack hi-res board. Connect the video monitor to 
the output jack of the hi-res board, then attach a 
40-pin edge connector from the TRS-80 to the hi- 
res board. Turn the mixing control fully 
countercockwise (Hi-Res Out). Power up the hi- 
res board, and then the rest of the system in 
normal order. 

As usual, MEMORY SIZE? should appear; if 
so enter 49152 (for a 48K computer). The system 
should operate as usual. Enter the following 
program: 

10 FOR X = 15360 TO 16383 

20 POKE X.129 

30 NEXT 

40 FOR X ■ -16384 TO 

50 POKE X,175 

60 NEXT 

70 GOTO 70 

The screen will fill with small graphics blocks. 
There will be a pause of almost a minute while 
the rest of the program is running. Put an AM 
radio next to the computer to determine when 
the program is complete. Now bring the mixing 
control of the hi-res board clockwise until dots, 
herringbone, jitter and/or other interference 
appears on the screen. This is a good sign. 

If you have a stable enough screen to see the 
alternating dot patterns produced by the hi-res 
board, then adjust the horizontal and vertical 
positioning controls, if necessary, to center the 
image with that of the TRS-80. To remove the 
jitter and herringbone adjust the fine tuning 
control. 

Now your screen should display an alternating 
pattern of TRS-80 graphics, along with an 
overlay of thin vertical lines of hi-res graphics 
dots. If you have any difficulty getting this 
pattern, or if there are any other problems, refer 
to the troubleshooting section. 

Use of the Hi-Res board is simple. Addresses 
from C000 through C03F contain the information 
to create the first line of dots, addresses C040 
through C07F contain the second line, etc. A 
contiguous block of memory from C000 through 
C2FF is used for the first twelve lines of dots. But 
since the display is twelve lines, and not sixteen, 
the addressing takes a jump in order to be 
compatible with the familiar 64 x 16 normal 
screen display. Thus, addresses C300 through 
C3FF are not used, and the second group of 12 
dot lines begins at address C400 and continues 
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through C6FF. Here is a full memory map of the 
Hi-Res board: 



Before continuing, clear out the hi-res 
memory with: 



Hi-Res Board Memory Map 



C000 
CD40 
C080 
COCO 
C100 
C140 
C1BQ 
C1C0 
C200 
C240 
C28Q 
C2C0 



C03F 
C07F 
COBF 
COFF 
C13F 
C17F 
C1BF 
C1FF 
C23F 
C27F 
C2BF 
C2FF 



Group 1 , 

Group 1 , 

Group 1 , 

Group 1 , 

Group 1 , 

Group 1 , 

Group 1 , 

Group 1, 

Group 1 , 

Group 1 , 

Group 1 , 

Group 1 , 



LiriB 
Line 
Line 
Line 
Line 
Line 
Line 
Line 
LinB 
Line 
Line 
Line 



Screen Line 
Screen Line 
Screen Line 
Screen Line 
Screen Line 
Screen Line 
Screen Line 
Screen LinB 8 
Screen LinB 9 
i Screen Line 10 
, Screen Line 11 
, Screen Line 12 



C400 - C43F 
C440 - C47F 



Group 2, Line 1, Screen Line 13 
Group 2, Line 2, Screen Line 14 



FOR X = -16384 TO : POKE X,0 : NEXT 

Drawing simple lines is an easy process; for a 
horizontal one, just enter: 

FOR X = -12288 TO -12224 : POKE X, 63 : NEXT 

A vertical one is produced by stepping through 
groups: 



C680 
C6C0 


- C6BF 

- C6FF 


Group 2, Line 11 , 
Group 2, Line 12, 


Screen Line 
Screen LinB 


23 
24 


CBQO 


- CAFF 


Group 3, Lines 1 
Screen Lines 25 - 


- 12 
36 




ccoo 


- CEFF 


Group 4, Lines 1 
Screen Lines 37 - 


- 12 
48 




0000 


- D2FF 


Group 5, Lines 1 
Screen Lines 49 - 


- 12 
60 




0400 


- DBFF 


Group 6, Lines 1 
Screen LinBS 61 - 


- 12 
72 




oeoo 


- DAFF 


Group 7, Lines 1 - 
Screen Lines 73 - 


- 12 
84 




DCOO 


- DEFF 


Group 8, Lines 1 
Screen Lines 85 - 


- 12 
96 




E000 


- EEFF 


Group 9, Lines 1 
Screen Lines 97 - 


- 12 
108 




E400 


- E6FF 


Group 10, Lines 1 
Screen Lines 109 


- 12 
- 120 




E800 


- EAFF 


Group 11 , Lines 1 
Screen Lines 121 


- 12 
- 132 




ECOO 


- EEFF 


Group 12, Lines 1 
Screen Lines 133 


- 12 
- 144 




FOOD 


- F2FF 


Group 13, Lines 1 
Screen Lines 145 


- 12 
- 156 




F400 


- F6FF 


Group 14, Lines 1 
Screen Lines 157 


- 12 
- 168 




F800 


- FAFF 


Group 15, Lines 1 
Screen Lines 169 


- 12 
- 180 




FCOO 


- FEFF 


Group 16, Lines 1 
Screen Lines 181 


- 12 
- 192 





5 CLS 

10 FOR Y « -16352 TO STEP 1024 

20 FOR X = Y TO Y+[ 12*64] STEP 64 

3D POKE X,1 : NEXT X 

40 NEXT Y 

50 GOTO 50 



REM KILL ALPHANUMERIC^ 
REM STEP THROUGH GROUPS 
REM STEP THROUGH LINES 
REM SET ONE PIXEL 
REM TO NEXT LINE GROUP 
REM KEEP DISPLAY INTACT 



Diagonal lines are more complicated, because 
more than two sets of increments must be 
specified; but simple diagonals can be created. 
For diagonals and variable-width lines, change 
listing to read as follows: 

10 INPUT Q : INPUT R : CLS 

20 FOR Y = -16352 TO STEP 1024 

30 FOR X = Y TO Y+I12*64) STEP 64+Q 

40 POKE X,[R AND 63) : NEXT X 

50 NEXT Y 

60 GOTO 60 

For serious graphics, assembly language 
programming is the only way real speed can be 
achieved. This is a very 'custom' type of 
programming, and only the simplest of 
subroutines will be presented here. For drawing 
circles, ellipses, and curves the functions will 
have to be stored in a look-up table and 
calculated. Listing 6-1 is an assembly listing 
to draw graphic lines on the screen, given a set of 
coordinates. 



Only six bits of each byte are used (the least 
significant six); thus, six one-bit-wide, memory 
chips are used in the circuit. The bits fit into 
their respective lines and memory addresses as 
follows: 



USED IS 
GRAPHICS 
MODE ONLY 



DOT COLUMN 
SOT USEE 
IN ALPHA 




FULL 

SCREE* 
IT 02* BYTES! 





q — c* <*> * "■» 




t~ t- t~ y~ t~ t~ 




in eh co cd cd to 


cooo 


O O O O O O C00 ' — ► C03F 


C040 


oooooo 


CO to 


oo oooo 




coco 


oo oooo 




C 100 


oo oooo 




C140 


oo oooo 




CliO 


oo oooo 




C ICO 


oo oooo 




C200 


00 oooo 




C 2 40 


oo oooo 


f 


CIIO 


oooooo ' 






C400 




T 

C6CO 
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Troubleshooting 



cooo 

0A7F 



7FD0 



7FJ00 CD7F0A 
7FD3 7C 
7FQ4 85 
7F05 A7 
7F06 2808 
7F08 FE01 
7F0A 2815 
7FQC FE02 
7F0E 2830 
7F10 C39719 



00100 ; «#*##t##«*t!*«<«t*t*tft#«#«««tfm##H«fHt«Hm*«*H« 

00110 ; ROUTINE TO DRAW HORIZONTAL AND VERTICAL LINES FR. BASIC 

00120 ; ttttttunittt,tutiintiiti,tttittti,,t,tmtnmnii 

00130 ; 

00140 HIRES EQU OCOOOH ; START OF HIRES GRAFIX 

00150 XFER EQU 0A7FH ; VARIABLE XFER ROUTINE 

00160 ; 

00170 ORG 7F0OH ; SOMEWHERE IN MEMORY 

00180 ; 

00190 

00200 

00210 

00220 

00230 ENTRY 

00240 



iririnnnrt,tHf»tHtti,iHtUtttlUtitttttttlttttH 

SUBROUTINE TQ DETERMINE THE CORRECT BASIC USRIX1 CALL 
iHHHUimii tt ttti t lilt t,t Hit ittlttmttttttlfHrtt 



00250 

00260 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

00340 

00350 

00360 

00370 

00380 ; 
7F13 AF 00390 PCLS 

7F14 F5 00400 

7F15 2100C0 00410 
7F1B F1 0042D PCLEAR 

7F19 77 D0430 

7F1A F5 00440 

7F1B 7C 00450 

7F1C B5 00460 

7F10 20F9 00470 

7F1F F1 00480 

7F20 C9 00490 

00500 

00510 

00520 

00530 

00540 

00550 

00560 

00570 

00580 

00590 

00600 

00610 

00620 

7F21 DD21897F 00630 PH0RI2 
7F25 CD6E7F 00640 



CALL 
LD 
AOD 
AND 

JR 
CP 
JR 
CP 
JR 
JP 



XFER 

A,H 

A,L 

A 

Z.PCLS 

1 

Z.PHORIZ 

2 

Z.PVERT 

1997H 



GET VALUE FROM BASIC 
GET MSB INTO ACCUM. 
ADO LSB FROM HL PAIR 
TEST IF IT IS ZERO 
CLEAR SCREEN ROUTINE 
TEST IF IT IS ONE 
HORIZONTAL LINE ON 1 
TEST IF IT IS A TWO 
VERTICAL LINE ON 2 
SN? ERROR IF NOT 1,2,3 



SUBROUTINE TO CLEAR THE SCREEN IN HIGH-RESOLUTION MODE 
BASIC FORMAT: M=USR[A). A MUST ALWAYS BE ZERO. 



XOR 

PUSH 

LD 

POP 
LD 

PUSH 
LD 

OR 
JR 

POP 
RET 



A 

AF 

HL, HIRES 

AF 

[HL),A 

AF 

A,H 

L 

NZ, PCLEAR 

AF 



GET CHARACTER TO WRITE 
SAVE THAT CHARACTER 
GET BEGINNING OF HI-RES 
RESTORE ZERO CHARACTER 
PUT IT IN PLACE IN MEM 
SAVE CHARACTER AGAIN 
GET MSB OF CURRENT LDC. 
GET LSB AND TEST PAIR 
LOOP BACK FOR NEXT 
GET STACK BACK IN SHAPE 
BACK TO CALLING ROUTINE 



titummumtiiittmututttttuttmtiitHttuni 

SUBROUTINE TO DRAW A HORIZONTAL LINE. BASIC FORMAT: 
P0KEN,B:C1=INT[C/6) : C2=C-C1 «6 : POKEN+1 ,C1 :P0KEN+2,C2: 
D1=INT(D/6) :D2=D-01*6:P0KEN+3,D1:P0KEN+4,D2:M=USR[1) 

B=LINE NUMBER (0-11, 16-27, 32-43, 48-59. 64-75. 80-91, 
96-107, 112-123, 128-139. 144-155, 160-171, 176- 
187. 192-203, 208-219. 224-235, 240-251 

C=OfiIGINATI0N POSITION (0-383). 

D=DESTINATION POSITION (0-383). C MUST BE LAHGER THAN D 

lltHtmmiHUIIItHHtHHIIIIIItllimitHHHtltl 



7F28 3A8C7F 
7F2B 4F 
7F2C AF 
7F2D 47 
7F2E E5 
7F2F D5 
7F30 E1 
7F31 09 
7F32 E5 
7F33 D1 
7F34 E1 
7F35 3ABB7F 
7F38 B6 
7F39 77 
7F3A 23 
7F38 AF 
7F3C 3A3F00 
7F3F ED52 
7F41 2804 
7F43 77 
7F44 23 
7F45 18F4 
7F47 3A8D7F 
7F4A B6 
7F4B 77 
7F4C C9 



00650 

00660 

00670 

00680 

00690 

00700 

D0710 

00720 

00730 

00740 

00750 

00760 

00770 

007 BO 

00790 

00800 L00P1 

00810 

00820 

00830 

00840 

00850 

00860 

00870 HOROUT 

00880 



00890 
00900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 
00980 
00990 
01000 
01010 
01020 
7F4D DD21997F 01030 PVERT 



LD 

CALL 

LD 

LD 

XOR 

LD 

PUSH 

PUSH 

POP 

ADD 

PUSH 

POP 

POP 

LD 

OR 

LD 

INC 

XOR 

LD 

sac 

JR 

LD 

INC 

JR 

LD 

OR 

LD 

RET 



IX, N 

FINDER 

A,(N+3) 

C,A 

A 

8, A 

HL 

DE 

HL 

HL.BC 

HL 

DE 

HL 

A,(N+2) 

(HL) 

(HL),A 

HL 

A 

A,(D3FH) 

HL.DE 

Z, HOROUT 

(HL) ,A 

HL 

L00P1 

A.1N+4) 

(HL) 

(HL) ,A 



POINT TO THE STORAGE 
GET STARTING POSITION 
GET VALUE AT "N+3" 
PUCE IN MSB OF BC 
CLEAR ACCUM TO ZERO 
PLACE IN LSB OF BC 
SAVE START LOC'N 
READY FOR XFER BACK 
TRANSFERRED BACK 
PERFORM THE ADDITION 
READY FOR TRANSFER 
AND GET INTO OESTIN'N 
RESTORE ORIGINAL VALUE 
GET VALUE AT "N+2" 
ADD TO CURRENT LOC'N 
AND PUT INTO PLACE 
NEXT SCREEN POSITION 
CLEAR ACCUM TO ZERO 
VALUE TO FILL BYTE 
PERFORM SUBTRACTION 
OUT OF ROUTINE 
PUT BYTE IN PLACE 
GET NEXT SCREEN POS'N 
GO BACK FOR NEXT FILL 
GET BACK FINAL BYTE 
ADD TO VALUE ON SCREEN 
PUT IT ON THE SCREEN 
AND BACK TO BASIC 



niruuiitlitittfliUttnnilttltiHttittlttflllfttni 

SUBROUTINE TO DRAW A VERTICAL LINE. 48K RAM IN PLACE. 

BASIC FORMAT: 

P0KEN,B:C1=INT(C/6) :C2=C-C1 »6:P0KEN+1 ,C1 :P0KEN+2,C2 

D1=INT[D/6):D2=D-O1»6:P0KEN+3,D1:POKEN+4,D2:M=USR(2) 

E=HORIZONTAL POSITION (0-255) 

F=LINE NUMBER (SEE HORIZONTAL LINE, ABOVE) 

G=LINE NUMBER [SEE HORIZONTAL LINE, ABOVE) 

ttt*tttttttttttHtttittHHttttttttmtttHHtttHtttHt 



LD 



IX, N 



Listing 6-1. Hires demonstration program. 



POINT TO THE STORAGE 

Listing Continued . . 



Without TRS-80 memory parallel to that in 
the hi-res board, it is not possible to read the 
contents of the high-resolution memory directly. 
The contents must be stored in some form 
elsewhere. When the high 16K block is in place 
in the expansion box, however, six bits of each 
byte are identical to those on the screen. Ideally, 
the entire block of high resolution memory (16K 
by 6 bits) and TRS-80 memory (16K by 8 bits) 
should be cleared out by POKEing in place 
first. Then an in-computer image of the high 
resolution screen can be maintained at all times. 

Another interesting mode of using the high 
resolution board is with a separate screen. 
Normal alphanumerics can appear on the TRS- 
80 monitor, while the high-resolution graphics 
can be presented on a parallel screen. This way, 
the table calculations and information reported 
can be displayed on the computer's monitor for 
reference. The high-resolution screen will be 
unaffected by anything done by the TRS-80 
unless its memory is being specifically written 
to. Not only can action games of the Startrek 
type be more interesting and challenging — with 
visuals and info displayed on different screens — 
but for experimentation and analysis, the high- 
resolution display is unbothered by program 
changes. 

To use this mode, merely leave your TRS-80 
monitor plugged into the computer. Then send 
the video information in the hi-res board to 
another video monitor, or to an ordinary 
television set via an RF modulator. 



Troubleshooting 

With a complicated project like this, there is a 
good chance that the system will not work 
perfectly the first time. The main problems 
together with their causes and solutions are 
outlined below. 

1. The screen keeps tearing or jittering no 
matter what setting the fine tuning is on. 
If the fine tuning has no effect at all, it may 
be defective. Replace it. If the tuning gets 
better, but can't quite pull it in, you can 
put another capacitor in parallel to 
increase the capacitance, or replace the 
crystal (in either the hi-res board or the 
TRS-80) with one better matched to the 
other. 

2. The high-resolution graphics cannot be 
changed, remaining the same as when the 
power was turned on. The memory write 
circuits are not working properly. Check 
the memory-select wiring at Z20; the write 
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Continued Listing 



7F51 CD6E7F 


01040 




CALL 


FINDER 


; GET SCREEN START BYTE 


7F64 E5 


01060 




PUSH 


HL 


SAVE THE START VALUE 


7F55 DD218C7F 01060 




LD 


IX.N+3 


POINT TO THE TABLE 


7F59 CD6E7F 


01070 




CALL 


FINDER 


AND DO THE WORK 


7F5C E5 


01080 




PUSH 


HL 


HEADY VALUE TO TRANSFER 


7F5D D1 


01090 




POP 


DE 


ANO TRANSFER TO DEST'N 


7F5E E1 


01100 




POP 


HL 


RESTORE START POSITION 


7F5F 014000 


01110 




LD 


BC.40H 


SCREEN BYTE LINE OFFSET 


7F62 AF 


01120 




XOR 


A 


CLEAR CARRY FLAG 


7F63 3A8B7F 


01130 




LD 


A,[N+2J 


GET BYTE FROH STORAGE 


7F66 77 


01140 


L00P2 


LD 


(HL) ,A 


STASH IT ON SCREEN 


7FB7 09 


01150 




ADD 


HL.BC 


MOVE UP ON THE SCREEN 


7FBB ED52 


01 160 




SBC 


HL.DE 


CHECK IF DONE YET 


7F6A 20FA 


01170 




JR 


NZ.L00P2 


BACK IF NOT DONE 


7FBC 77 


01180 




LD 


(HL] ,A 


PUT LAST BYTE IN 


7F60 C9 


01190 
01200 




RET 




BACK TO BASIC 




01210 


; turn titttnttttnntttttit mitt ttnntiitt it titttnt 




01220 


; FINDER SUBROUTINE LOCATES PROPER BYTE WITHIN HIRES ARE/ 




01230 


; iiitttit§IHtlii1iitttitHHtHttttittlHHmitHMH 




01240 


; 








7F6E 2100CO 


01250 


FINDEF 


LD 


HL, HIRES 


GET HI-RESOLUTION SCRN 


7F71 DD7E00 


012B0 




LD 


A, (IX) 


GET START BYTE OFFSET 


7F74 47 


01270 




LD 


B,A 


PLACE IN B REGISTER 


7F75 AF 


012B0 




XOR 


A 


CLEAR THE CARRY FLAG 


7F7B CB18 


01290 




RR 


B 


DIVIDE BY TWO AND ... 


7F78 CB19 


01300 




RH 


C 


... ROTATE IN ORDER ... 


7F7A CB1B 


01310 




RR 


B 


. . . ACTUALLY TO . . . 


7F7C CB1B 


01320 




RR 


C 


... MULTIPLY BY 64 


7F7E 09 


01330 




ADD 


HL.BC 


MAKE NEW SCREEN PDS'N 


7F7F E5 


01340 




PUSH 


HL 


READY IT FOR TRANSFER 


7F80 D1 


01350 




POP 


DE 


TRANSFER TO DESTIN'N 


7F81 DD7E01 


01360 




LD 


A,(IX+1) 


GET START BIT OFFSET 


7F84 4F 


01370 




LD 


C,A 


PLACE IN MSB OF BC 


7FB5 AF 


01380 




XOR 


A 


CLEAR ACCUM TO ZERO 


7FB6 47 


01390 




LD 


B,A 


PLACE IN LSB OF BC 


7F87 09 


01400 




ADD 


HL.BC 


GET NEW START BIT 


7FBB C9 


0141 D 
01420 




RET 




BACK TO CALLING ROUTINE 


7F89 


01430 
01440 


N 


ECU 


« 


MOMORY STORAGE POS'NS 


06 CC 


01450 




END 


06CCH 


BACK TO BASIC 


00000 TOTAL 


ERRORS 










30026 TEXT AREA BYTES LEFT 






ENTRY 7F00 


00230 










FINDER 7F6E 


01250 


00640 


01040 0107C 




HIRES C000 


00140 


00410 


01250 






HOROUT 7F47 


00970 


00830 








L00P1 7F3B 


00800 


00860 








L00P2 7F66 


01140 


01170 








N 7F8S 


01430 


00630 


00650 0076C 


PCLEAfl 7F1B 


00420 


D0470 








PCLS 7F13 


00390 


00270 








PHORIZ 7F21 


00630 


00280 








PVERT 7F40 


01030 


00310 








XFER 0A7F 


00150 


00230 









lines to the memory (Zll); and the write 
line from the computer (from edge card pin 
13). 

3. The high-resolution graphics keep 
changing without writing to them. The 
memory-select circuits may be selecting 
write for both read and write; check Zll. 
More likely, the memory refresh/select 
circuitry is miswired; check Z9a and Z3. 

4. When creating lines of graphics, the dots 
do not appear in the correct place. This 
indicates the memory data and /or address 
lines are miswired; check the lines from the 
computer (pins 4-7, 9-11, 17-18, 20, 22, 
24-28, 30-32, 34-36, 38 and 40), making sure 
they are in the correct order. Also check 
each memory circuit to be sure the address 

lines (pins 4-7, 10-13, and 15) are parallel in 
each memory IC. Finally, be sure Z4 
correctly feeds Z10; Z5 correctly feeds Zll; 
Z6 correctly feeds Z12; and Z7 correctly 
feeds Z13. These four circuits are the 
memory count/multiplex circuits. Also 
check that Z10, 11, 12 and 13 correctly feed 
Z18 and 19. 

5. No graphics are produced. This is a 
tough one. The fault could lie with 

(a) the clock formed by Zla-c 

(b) the memory refresh circuits Z9b and Z3 

(c) latch and shift registers Z16 and Z17 

(d) memory circuits Z21 to Z26 

(e) video output formed by Z30, Ql and Q2. 

Check the screen display carefully, because if 
any of these sections are working (except the 
video output) the screen will be affected in some 
way, even if it is minor. If herringbone or some 
tearing is present when the fine tuning is 
adjusted, then the video output and sync 
circuits are probably okay. Also, be sure that 
the mixing control is not turned fully 
counterclockwise (TRS-80 on, hi-res off). 

6. The computer crashes to MEMORY 
SIZE? or otherwise acts problematically. 
The hi-res board has no effect on the 
computer. No data is written to the 
computer from the hi-res board at any 
point; it only receives information. If the 
computer crashes, then faulty wiring is 
likely. 
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Hires Graphics Example 




Photo 6-1. Hi-Res graphics example. 
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Replace BASIC ROMs 

In the past few years, more and more TRS-80 
users have asked me the question, "I don't need 
BASIC because I do all my work in machine 
language. How can I use that space for my own 
routines and language in ROM?". The answer is 
simple: replace your ROMs with 2716 (2K x 1 
byte), 2732 (4K x 1 byte) or 2764 (8K by 1 byte) 
EPROMs. 

The process is electronically simple. The Level 
II (or Level I) ROMs are removed, and a board 
containing the new and old ROMs is inserted at 
the edge connector. This board, then, can select 
either ROMs at the flick of a switch - exactly like 
the Apple's 'softcards' do it. 

This section will present a circuit to use 2716 
EPROMs and any other ROMs together and, as a 
bonus, a way to hand control of your TRS-80 over 
to another microprocessor! The power of such 
processors as the 6502, 6800 series, the 8060 
(SC/MP) and others then becomes available to 
the TRS-80 user. Together with the appropriate 
bootstrap and executive programs in ROM, the 
TRS-80 can act with the strengths of almost any 
language and almost any processor. 



There is no secret to adding ROM. The area 
from 0000 to 37C0 is free to use, and some of that 
method has already been presented. Figure 6-5 
presents the circuitry that will handle seven 2716 
EPROMs, switchable with the 3-chip Level II 
ROM set. 

The real trick is making another processor 
available to the TRS-80's hardware. This other 
processor must be able to: 

- access memory and peripherals in the 
TRS-80 memory map 

- address at least 32K of memory 

- be able to move its software stack 
anywhere in memory 

- refresh the 4116 dynamic memories. 

Of these restrictions, the last two are the 
trickiest. Without also placing RAM on this 
outboard device, the 6502 cannot be used, 
because it requires its stack in page 1 (01 00-0 IFF) 
and many of its fastest (and hence most 
advantageous) instructions are limited to page 
(0000-OOFF). 




Figure 6-5. Circuit for replacing BASIC ROMs. 



1 . REMOVE DIP SHUNT Z3 . 

2. ALL SEVEN 2716 'S ARE CONNECTED IN 
PARALLEL EXCEPT PIN 1B. 
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However, the refresh requirement is the most 
severe. Because the RAS-only refresh is 
controlled within the TRS-80, and its signals are 
killed when the processor is removed, the entire 
refresh process must be handled outside the 
computer by chips which were not designed for 
dynamic memory support. 

Before turning to the details, you may be 
asking "How can control be wrested from the Z- 



80?". The answer is found in the line marked 
TEST. This input line is present on pin 23 of the 
TRS-80 bus, and when brought low, causes all 
address lines (A0-A15), all data lines (D0-D7), 
read (RD), write (WR), input (IN), output 
(OUT), row address strobe (RAS), column 
address strobe (CAS) and memory select 
multiplex (MUX) to be put into three-state 
condition. This provides a wide-open computer 
bus for the outside world. 



Power-Up Monitor 



> 






> 




I 



r5V 



r 



— X 



POWER UP TO MONITOR 


AT 


3000 h 




MONITOR MUST EXECUTE 








3000 C3D33Q 




JP 


3D03H 


3003 AF 




XDfl 


A 


3U04 0300 




XT 


(Q),A 



Figure 6-6. Modification needed for power-up monitor. 



From my programmer (but not my user!) 
point of view, entering BASIC immediately 
upon power-up, or reset, is inconvenient and 
sometimes maddening. Rather, I would prefer a 
jump to a monitor of the type which can be 
found on the Ohio Scientific microcomputers: 
instead of MEMORY SIZE?, the user is 
presented with 'D/C/W/M?', which means 'Disk 
reboot, Cold start in BASIC (MEMORY 
SIZE?), Warm start in BASIC (READY), or 
Machine Language Monitor?'. 

The user can exit from BASIC to the monitor 
and back at any point without jumping to a 
program-creaming MEMORY SIZE? The cold 
start serves that purpose, and is almost always 
by choice. 

There is such a possibility on the TRS-80, so 
long as two conditions are met: 

1. A machine language monitor is resident, 
preferably in ROM. 

2. The restart from 0000 is redirected from 
BASIC to that machine language monitor, 
and/or the NMI located at 0066 is redirected 
to that machine language monitor. This 
latter configuration preserves the last 
location of the program counter on the stack 
for examination. 



The first requirement is easy to meet, and is in 
my opinion the most logical use of a ROM 
memory addition. 
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00100 




00110 




00120 




00130 




00140 




00150 


401A 


00160 


3000 


00170 




00180 




001 90 




00200 




00210 




00220 




00230 


3000 F3 


00240 


3001 E073E242 


00250 


3005 31E042 


00260 


300B F5 


00270 


3009 CS 


00280 


300A 05 


DD290 


300B E5 


00300 


300C 21003C 


00310 


300F 11013C 


00320 


3012 01FF03 


0033D 


3015 3620 


00340 


3017 EDBO 


00350 




00360 




0O37O 




00380 




00390 




00400 


3019 218732 


00410 


301C 11C03C 


D0420 


301 F CD8F32 


00430 


3022 CDC331 


00440 


3025 FE63 


00450 


3027 2B13 


00460 


3029 FEE4 


00470 


302B CA0000 


00480 


302E FE6D 


D04SO 


3030 283D 


00500 


3032 FE75 


00510 


3034 2B22 


00520 


3036 FE77 


00530 


3038 282A 


00540 


303A 1BE6 


00550 




00560 




00570 




005B0 




00590 




00600 




00610 


303C F3 


00620 


303D AF 


00630 


303E D3FF 


00640 


3040 210206 


00650 


3043 110040 


0Q660 


3046 013600 


00670 


3049 EDBO 


00680 


304B 3D 


00690 


304C 3D 


00700 


304D 20EF 


00710 


304F 0627 


00720 


3051 12 


00730 


3052 13 


00740 


3053 10FC 


00750 


3055 C37500 


00760 




00770 




00780 




00790 




OOBOO 




00810 




00B20 


3058 E1 


00830 


3059 D1 


00840 


305A C1 


00B50 


305B F1 


00860 


305C ED7BE242 00870 


3060 2ABE40 


00880 


3063 E9 


00890 




00900 




00910 




00920 




00930 




009 40 


3064 E1 


00850 


3065 D1 


0OB60 


3066 C1 


00970 


3067 F1 


00980 


3068 ED78E242 00990 


306C C3CC06 


01000 




01010 



tiuinmtHitmmitiiiittiiiiimittttimiittiim 

POWER-OP PROGRAM FOR USE INDEPENDENTLY (WITHOUT BASIC 
ROMS IN PLACE) OR IN CONJUNCTION WITH EXIT AND RE-ENTRY 
TO BASIC UP RESET TO 0000 (BEFORE DISC SYSTEM REBOOT). 
fttmnnttiiiiiitiiiniKiiimtiiiiiiiiiuiiiiitiitt 



EOLI 

one 



401AH 
3000H 



RAM STORAGE FOR STROKE 
MONITOR ENTRY POINT 



; tinnmmmunmimt/tittntitintintintttim 

; OPTIONAL SCREEN-CLEAR. IF THE EXIT CONDITION OF THE 
; SCREEN IS IMPORTANT, THEN ELIMINATE CLEARING PROCESS 



DI 




; KILL THE INTERRUPTIONS 


LD 


(42E2H1.SP 


; SAVE STACK POINTER 


LD 


SP.42E0H 


; GET NEW STACK POINTER 


PUSH 


AF 


; SAVE REGISTERS FOR 


PUSH 


BC 


; LATER DISPLAY 


PUSH 


DE 


; DURING THE 


PUSH 


HL 


; MONITOR ENTRY 


LD 


HL.3C00H 


; BEGINNING OF SCREEN 


LD 


DE.3C01H 


; NEXT POSITION ON SCREEN 


LD 


BC.3FFH 


; NUMBER OF SCREEN POS'NS 


LD 


(HL) ,20H 


; PRINT SPACE 1ST POS'N 


LDIR 




; DO IT FOR WHOLE SCREEN 



LD 


HL.MSG01 


LD 


DE.3CC0H 


CALL 


DISPLY 


CALL 


INPUT 


CP 


63H 


JR 


Z.COLD 


CP 


64H 


JP 


Z.0000 


CP 


6DH 


JR 


Z.MONTOR 


CP 


75H 


JR 


Z.USER 


CP 


77H 


JR 


Z.WARM 


JR 


MENU 



DISPLAY DISK/MONITOR/WARM START/USER ROUTINE MESSAGE 
tfttttttHtttttttHtttHttttitmittmtHtHlitlttWU 



GET FIRST MESSAGE 
GET DISPLAY POSITION 
AND DISPLAY ON SCREEN 
GET INPUT FROM KEYBOARD 
IS IT A LETTER "C"? 
GO TO COLDSTART ROUTINE 
IS IT A LETTER "D"? 
GO TO DISK REBOOT 
IS IT A LETTER "M"? 
GO TO MACHINE MONITOR 
IS IT A LETTER "U"? 
GO TO USER ROUTINE 
IS IT A LETTER "W"? 
GO TO BASIC WARMSTART 
LOOP BACK IF NONE 



tttttttttt ###########################################*♦ 

COLDSTART ROUTINE DUPLICATES LEVEL II ACTION TO 0075H. 
STACK POINTER NOT RESET HERE BECAUSE COLDSTART DOES IT. 
tfttttfttMHmtltttlHHtlHHIHIIHHttHittttmi 

; INTERRUPTS TURNED OFF 

; CLEAR ACCUMULATOR 

CLEAR OUT (OFFH) ,A ; BEGIN WHITE-PORT LOOP 

; GET COMMUNICATION BLOCK 

; GET COMMUNICATION AREA 

; GET SIZE OF COMM. BLOCK 

; BLOCK MOVE COMM. AREA 

J A = A-1 (A=0 AT START) 

; A = A-1 (FE, FC, FD...) 

; CLEAR ALL EVEN PORTS 

; GET 39 VAR. LOCATIONS 

; BEGIN SETTING UP CHARS 

J GET NEXT MEM POS'N 

; LOOP THROUGH THEM ALL 

; REST OF BASIC STARTUP 

if ittiHumtmitttitnHti/ntttttfttttttiHttiittn 

USER ENTRY ROUTINE REQUIRES THAT A TWO-BYTE ADDRESS B 
STORED IN MEMORY AT 408E/40BF (16526/16527), <=USR(0)> 

iitiftiiitiniittittifitiininmnm miimiittitu 



BEGIN TO CLEAR THE 
STACK OF ALL 
REGISTERS PUSHED 
AT ENTRY POINT 

GET ORIGINAL STACK PTR 

GET USR(O) ENTRY POINT 

AND JUMP TO IT 



HttttlttmtttttHtttHHHtHtHttttttfUttlttttttlttt 

WARM START ROUTINE RESTORES STACK BEFORE GOING TO BASIC 

mtttmtnttmmmiHtmtmiiitttitmmttmm 



RESTORE ALL REGISTERS 
PUSHED ON STACK 
WHEN MONITOR 
WAS ENTERED 
GET ORIGINAL STACK PTR 
GO TO BASIC WARMSTART 



DI 




XOR 


A 


OUT 


(OFFH), A 


LD 


HL.06D2H 


LD 


DE.40DOH 


LD 


BC.0036H 


LDIR 




DEC 


A 


DEC 


A 


JR 


NZ, CLEAR 


LD 


B.27H 


LD 


IDE), A 


INC 


DE 


DJNZ 


L00P1 


JP 


007 5H 



POP 


HL 


POP 


DE 


POP 


BC 


POP 


AF 


LD 


SP,(42E2H) 


LD 


HL, I408EH) 


JP 


(HL) 



POP 


HL 


POP 


Dt 


POP 


BC 


POP 


AF 


LD 


SP.142E2H) 


JP 


06CCH 



Listing 6-2. Power-up monitor program. 

■t k^ Chapter 6 



How Interpreters Work 



The concept of computer languages is far too 
complex for a single section, a single chapter or 
even a single book. They run from easy, messy, 
but capable languages like BASIC through hard 
and messy languages like FORTRAN, to neat, 
structured, but obtuse languages like Pascal and 
LISP. In between are pseudo B ASICs like 
BASEX, plus a whole range of compiled 
languages and hybrid self-definers like FORTH. 

All these languages have one thing in 
common: they must eventually be broken into 
subroutines which operate in the machine 
language of the host processor. Compiled 
languages are broken into these subroutines 

when the program is written, but the bulk of 
material installed in small computers is 
accessed most easily by means of interpreters - 
executing one statement at a time, during a 
program's run. 

How does a computer get to the information 
to be interpreted or compiled? Here's a short 
rundown of how an interpreter does its work; 
compilers are similar, but they won't be 
covered here. 

Once a program has been constructed (and the 
method varies from machine to machine) it is in 
place for the computer to evaluate and execute. 
The process that follows is consistent with most 
interpreters: 

Once a program has been constructed, and 
the method varies from machine to machine, it 
is in place for the computer to evaluate and 
execute. The process that follows is consistent 
with most interpreters: 

1. Upon an execution command, the 
interpreter identifies the start of the 
program. 

2. The first command from the program is 
obtained. The interpreter compares this 
command, byte for byte, against a table of 
legitimate commands. In some interpreters, 

the commands are stored as full words; in 
others, they are tokenized. When a valid 
entry is found in the command table, this 
stage of interpretation is complete. If a valid 
entry is not found, the routine is exited, 
usually via a loop which can be intercepted 
by extensions to the interpreter. 



How Interpreters Work 





01020 


; HHHfHtittHHHttttlMttHHIItHtHltttttumtttt 




01030 


; MACHINE LANGUAGE MONITOR IS 


SIMPLE, DISPLAYING REGISTER 




01040 


; CONDITIONS 


VT ENTRY, AND ACCEPTING MEMORY CHANGES. ALL 




01050 


; REGISTERS ARE RESTORED UPON 


EXIT FROM THIS ROUTINE. 




01060 


; ItntimiHUIHittttitHtHttH 




01070 










306F 210632 


01080 


HONTOR 


LD 


HL.MSG02 


i GET REGISTER DISPLAY 


3072 11C03C 


01090 




LD 


DE,3CC0H 


; GET SCREEN POSITION 


3075 C08F32 


01100 




CALL 


DISPLY 


i DISPLAY THE MESSAGE 


3078 110030 


01110 




LD 


DE.3000H 


; GET SCREEN POSITION 


307B ED4BE242 


01120 




LD 


BC.I42E2HJ 


i GET STACK POINTER POS'N 


307F C5 


01130 




PUSH 


BC 


; GET VALUE READY TO XFER 


3080 E1 


01140 




POP 


HL 


J TRANSFER BYTES TO HL 


3081 CD1731 


01150 




CALL 


WORDER 


; CONVERT S DISPLAY BYTE 


3084 00E5 


01160 




PUSH 


IX 


; GET IT READY TO USE 


3086 E1 


01170 




POP 


HL 


! AND DO IT WITH IT 


3087 CD1731 


01180 




CALL 


WORDER 


; CONVERT & DISPLAY BYTES 


308A F0E5 


01190 




PUSH 


IY 


; GET IT READY TO USE 


308C E1 


01200 




POP 


HL 


; AND DO IT WITH IT 


308D CD1731 


01210 




CALL 


WORDER 


i CONVERT & DISPLAY IT 


3090 2A0E42 


01220 




LD 


HL.142DEH) 


i POINT TO AF STACK VALUE 


3093 C01731 


01230 




CALL 


WORDER 


; CONVERT i DISPLAY BYTE 


3096 2ADC42 


01240 




LD 


HL,(42DCH) 


; POINT TO BC STACK VALUE 


309S CD1731 


01250 




CALL 


WORDER 


; CONVERT t. DISPLAY BYTE 


309C 2ADA42 


01260 




LD 


HL.142DAH) 


; POINT TO DE STACK VALUE 


309F CD1731 


01270 




CALL 


WORDER 


; CONVERT & DISPLAY BYTE 


30A2 2A0842 


01280 




LD 


HL,(42D8H) 


; POINT TO HL STACK VALUE 


30A5 CD1731 


01290 




CALL 


WORDER 


; CONVERT & DISPLAY BYTE 


30A8 ED5F 


01300 




LD 


A,R 


; GET R REGISTER INTO A 


30AA 67 


01310 




LD 


H,A 


i GIVE IT FOR CONVERSION 


3QAB ED57 


01320 




LD 


A, I 


; GET I REGISTER INTO A 


30AD 6F 


01330 




LD 


L,A 


; GIVE IT FOR CONVERSION 


30AE CD1731 


01340 




CALL 


WORDER 


; CONVERT & DISPLAY BYTE 


3081 118030 


01350 




LD 


DE.3D80H 


; GET NEW VIDEO POSITION 


30B4 08 


01360 




EX 


AF.AF' 


; TRANSFER OTHER VALUE 


SOBS F5 


01370 




PUSH 


AF 


1 READY TO XFER TO HL 


3086 E1 


01380 




POP 


HL 


; EFFECT TRANSFER TO HL 


3087 08 


01390 




EX 


AF.AF' 


; RETURN ORIGINAL VALUE 


3088 C01731 


01400 




CALL 


WCRDER 


i CONVERT * DISPLAY EYTL" 


30BB D9 


01410 




EXX 




; TRANSFER BC, DE, HL 


30BC E5 


01420 




PUSH 


HL 


; FIRST SLIP BC ON STACK, 


30BD 05 


01430 




PUSH 


DE 


; THEN PUSH DE THERE, 


30BE CS 


01440 




PUSH 


BC 


; AND THEN THE LAST ONE. 


30BF D9 


01450 




EXX 




i TRANSFER REGISTERS BACK 


30C0 E1 


01460 




POP 


HL 


i GET VALUE ALL READY 


30C1 CD1731 


01470 




CALL 


WORDER 


i CONVERT & DISPLAY BYTE 


30C4 E1 


01480 




POP 


HL 


i GET DE VALUE READY 


30C5 CD1731 


01490 




CALL 


WORDER 


; CONVERT H DISPLAY BYTE 


30CB E1 


01500 




POP 


HL 


; GET HL VALUE READY 


30C9 CD1731 


01510 




CALL 


WORDER 


; CONVERT & DISPLAY BYTE 


30CC 11003F 


01520 


CHECK 


LD 


DE.3F00H 


; GET NEW SCREEN POS'N 


30CF CD1731 


01530 




CALL 


WORDER 


; CONVERT 6. DISPLAY BYTE 


30D2 1C 


01540 




INC 


E 


; BUMP SCREEN POSITION 


3003 7E 


01550 




LD 


A,(HL) 


i GET VALUE FROM MEMORY 


3004 C02431 


01560 
01570 




CALL 


HEXASC 


; AND DISPLAY IT IN ASCII 




01580 


■ ftumiumi 




01590 


; ADDRESS MOD 


ROUTINE GETS KEYBOARD VALUE & LOOPS BACK 




01600 


; >*#**#tl#«tf#«f#f«t#««f#«tt##««*«f#«i#«#f#f«*tfftff«««« 




01610 


; 








3007 CDC331 


01620 


ADOMOD 


CALL 


INPUT 


; GET VALUE FROM KEYBOARD 


300A FE21 


01630 




CP 


•1' 


; TEST FIRST IF EXECUTE 


300C 2832 


01640 




JR 


Z.EXEC 


; OUT IF EXECUTE COMMAND 


300E FE2F 


01650 




CP 


V 


; TEST SECONO IF DATA 


30E0 CA6E31 


01660 




JP 


Z.OATMOD 


; OUT IF DATA MOD COMMAND 


30E3 FE2A 


01670 




CP 


i* t 


j TEST THIRD IF RET MENU 


30E5 CA0C30 


01680 




JP 


Z.CLS 


; OUT TO MENU IF A STAR 


30E8 FE30 


01690 




CP 


'0' 


; SEE IF <0 CHARACTER 


3QEA 3BEB 


01700 




JR 


C.ADDMOO 


; LOOP BACK IF <0 CHAR. 


30EC FE67 


01710 




CP 


B7H 


; SEE IF >F CHARACTER 


30EE 30E7 


01720 




JR 


UC, ADOMOD 


; LOOP BACK IF >F CHAR. 


30FO FE3A 


01730 




CP 


i . i 


; SEE IF <9 CHARACTER 


30F2 3804 


01740 




JR 


C, NUMB EH 


; GO TO NUMBER ROUTINE 


30F4 FE61 


01750 




CP 


61 H 


; SEE IF >A CHARACTER 


30F6 38DF 


01760 




JR 


C, ADOMOD 


i LOOP BACK IF <A & >9 


30F8 21043F 


01770 


NUMBER 


LD 


HL.3F04H 


; GET ADDRESS SCREEN POSN 


30FB 11033F 


01780 




LD 


0E,3F03H 


; GET NEXT SCREEN POS'N 


30FE 010300 


01790 




LD 


BC,3 


; GET THREE TOTAL POS'NS 


3101 EOBO 


01800 




LOIR 




; AND MOVE THEM OVER 


3103 2B 


01810 




DEC 


HL 


; REPOSITION TO LAST CHAR 


3104 FE60 


01820 




CP 


60H 


; COMPARE TO L.C. ALPHA 


3106 3802 


01830 




JR 


C, ZIPBY 


; IF NUMBERIC, THEN SKIP 


3108 D620 


01840 




sua 


20H 


; ELSE CONVERT TO U.CASE 


31 OA 77 


01850 


ZIPBY 


LD 


IHL),A 


; DISPLAY NEW CHARACTER 


31 OB C04331 


01860 


NUM2 


CALL 


ASCHEX 


J CONVERT DISPLAY TO HL 


310E 1BBC 


01870 




JR 


CHECK 


; AND LOOP BACK FOR MORE 


3110 21063F 


01880 


EXEC 


LD 


HL.3F06H 


; POINT HL TO ADDRESS 


3113 CD4331 


01890 




CALL 


ASCHEX 


; AND CONVERT TO HEX 


3116 E9 


01900 
01910 




JP 


(HL) 


; HL CONTAINS ADDRESS 




01920 


; nutttiitiiiittmitutittitii 




01930 


; SUBROUTINE 


RESPONSIBLE FOR 


CONVERTING 6, DISPLAYING TWO- 




01940 


; BYTE 


WORDS 


DELIVERED TO IT 


IN THE HL REGISTER. 



Listing Continued . . . 



3. If the command is identified as a 
legitimate one, a subroutine is called which 
executes the command. That subroutine in 
turn may further examine the command line 
for operands and conditions, incrementing 
and decrementing pointers in its search for 
required, and valid, information. Further 
subroutines are entered as necessary to 
evaluate and put to use this additional 
information. In-memory variables and 
pointers are set up, modified, and accessed 
by all subroutines, usually from a master 
table which defines variable types and 
syntax conditions. Transcendental functions 
are also accessed via tables within the 
interpreter itself. Error checking is done at 
all points. 

4. When the execution of each subroutine is 
completed, it returns to the calling program. 
Eventually, all subroutines have returned to 
their upper level of subroutine 'nesting'. 
Then the execution routine finds itself 
re-entered, positioned at the next executable 
point in the program, where the execution 
process is repeated. 

5. The execution routine may, depending on 
the language, find itself repositioned in the 
program out of normal execution sequence. 
On the other hand, some languages have an 
inherent structure which disallows any 
repositioning, demanding an inviolable first 
to-last execution sequence. In these latter 
interpreters, repositioning will be interpreted 
as an error condition. 

6. If any information, commands, program 
order or program syntax is incorrect, an error 
handling routine is entered, usually by direct 
jump rather than subroutine call. Normally, 
this routine prepares and presents an error 
message. It returns the program from 
execution level, arbitrarily cancelling any 
nested execution subroutines by readjusting 
stack pointers and other variable information. 

This readjustment is necessary to avoid 
unsettling the user-interactive command- 
level routine, and causing the processor to 
lose its way in a complex of incomplete 
subroutines. 

7. Upon completion of all program 
statements, the program is returned from 
execution level to command level. Some 
interpreters allow commands to be entered, 
interpreted, and executed from a command 
buffer, without actually entering a program 
execution condition. 
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Continued Listing 

019S0 ; tttttttHt*HtHitlHHitlttHtimHt§tttttHttttHH§ 

01960 ; 



156 



3117 1C 


01 970 WORDER 


INC 


E ; 


BUMP DE REGISTER ALONG 


311B 1C 


01980 




INC 


E J 


SOME MORE BUMPING . . . 


3119 1C 


01990 




INC 


E i 


... AND SOME MORE OF IT 


311A 7C 


02000 




LD 


A,H ; 


GET FIRST BYTE OF IT 


31 1B CD2431 


02010 




CALL 


HEXASC ; 


CONVERT k. DISPLAY BYTE 


311E 7D 


02020 




LD 


A,L ; 


GET SECOND BYTE OF IT 


311F CD2431 


02030 




CALL 


HEXASC i 


CONVERT & DISPLAY BYTE 


3122 1C 


02040 




INC 


E J 


AND POSITION SCREEN 


3123 C9 


02050 
02060 




BET 


* 


AND BACK TO CALLER 




02070 


MHtltitttm 




02060 


HEXADECIMAL 


TO ASCII CONVERSION 


FOR TWO-BYTE WORDS 




02090 


mtttttttnunifumtuttmiiruititiiintitttuunt 




02100 










3124 F5 


02110 HEXASC 


PUSH 


AF J 


SAVE BYTE IN AF REG. 


3125 E6F0 


02120 




AND 


OFOH ; 


AND MASK OUT LOW NYBBLE 


3127 OF 


02130 




RRCA 


; 


BEGIN ROTATING BIT ... 


3128 OF 


02140 




RRCA 


; 


... IN ORDER TO TEST... 


3129 OF 


02150 




RRCA 


j 


... THE LOW NYBBLE ... 


31 2A OF 


02160 




RRCA 


; 


... ALL BY ITSELF. 


31 2B CD3931 


02170 




CALL 


HXAC ; 


BYTE RANGE EVALUATION 


31 2E 12 


02180 




LD 


IDE], A ; 


DISPLAY ON THE SCREEN 


312F 1C 


02190 




INC 


E ; 


AND MOVE TO NEXT POS'N 


3130 F1 


02200 




POP 


AF ; 


RESTORE ORIGINAL BYTE 


3131 E60F 


02210 




AND 


OFH 


AND MASK OUT HIGH BITS 


3133 CD3931 


02220 




CALL 


HXAC ; 


RANGE EVALUATION ROUT. 


3136 12 


02230 




LD 


IDE), A ; 


AND DISPLAY ON SCREEN 


3137 1C 


02240 




INC 


E ; 


MOVE TO NEXT VIDEO POSN 


3138 C8 


02250 
02260 




BET 


! 


AND BACK TO CALLER 




02270 


tint in tun ftiummtutttttn 




02280 


HEX-ASCII RANGE EVALUATION FOR 


TO 9 AND A TO F AREAS 




02280 


ettttttttuHmttmttffrtiituettttfitHiittfttiiittt 




02300 












02310 










3139 FEDA 


02320 1 


1XAC 


CP 


OAH ; 


CHECK AGAINST 1D DEC. 


3138 3003 


02330 




JB 


NC.NEXTX 


IF >10 THEN ALPHA CHAR 


313D C630 


02340 




ADD 


A.30H ; 


ELSE NUHERIC - CONVERT 


313F C9 


02350 




RET 




AND BACK TO CALLER 


3140 C637 


02360 


4EXTX 


ADD 


A.37H ; 


ALPHABETIC - CONVERT 


3142 C9 


02370 
02380 




BET 




AND BACK TO CALLER 




02390 


UttttH 




02400 


ASCII 


TO HEXADECIMAL CONVERSE 


FOR TWO-BYTE WORDS 




02410 


flttltUttHttltlltllHKHttttlltttlilltlltltfHtUItt 




02420 












02430 










3143 CD6331 


02440 


\SCHEX 


CALL 


ACHX 


RANGE EVALUATION ROUT. 


3146 4F 


02450 




LD 


C,A , 


SAVE PART OF CONVERSION 


3147 2B 


02460 




DEC 


HL 


AND GET NEXT BYTE 


3148 CD5B31 


02470 




CALL 


LLLLS 


EXECUTE LEFT ROTATES 


314B 81 


02480 




ADD 


A,C 


AND ADD TO MAKE BYTE 


314C 4F 


02490 




LD 


C,A 


SAVE IT BACK IN C REG. 


3140 2B 


02500 




DEC 


HL 


AND MOVE TO NEXT BYTE 


31 4E CD6331 


02510 


0(2 


CALL 


ACHX 


00 RANGE EVALUATION 


3151 47 


02520 




LD 


B,A 


AND SAVE IT IN B REG. 


3152 2B 


02530 




DEC 


HL 


BET FINAL BYTE READY 


3153 CD5B31 


02540 




CALL 


LLLLS 


AND EXECUTE LEFT ROTATE 


3156 60 


02550 




ADD 


A,B 


CREATE COMPLETE BYTE 


3157 47 


02560 




LD 


8, A 


AND SAVE IT IN B REG. 


3158 C5 


02570 




PUSH 


BC 


GET 2 BYTES TO XFER 


3159 El 


02580 




POP 


HL 


TRANSFER TO HL REGISTER 


31 5A C9 


02590 




RET 




AND BACK TO CALLER 


31 5B CD6331 


02600 


LLLLS 


CALL 


ACHX 


EVALUATE RANGE OF CHAR 


31 5E 07 


02610 




RLCA 




BEGIN LEFT ROTATES ... 


31 5F 07 


02620 




RLCA 




... WHICH WILL POS'N... 


3160 07 


02630 




RLCA 




... BYTE READY FOR ... 


3161 07 


02640 




RLCA 




... CONVERSION. 


3162 C9 


02650 




RET 




AND GO BACK TO CALLER 


3163 7E 


02660 


ACHX 


LD 


A.IHL) 


GET BYTE FROM SCREEN 


3164 FE40 


02670 




CP 


40 H 


CHECK AGAINST ALPHA 


3166 3003 


02680 




JR 


NC,NEXTZ 


IF NUMERIC THEN JUMP 


3168 0630 


02690 




SUB 


3DH 


ELSE NUMBER TO HEX 


31 6A C9 


02700 




RET 




AND BACK TO CALLER 


316B D637 


02710 


NEXT2 


SUB 


37H 


THEN IT'S ALPHA TO HEX 


31SD C9 


027 2D 
02730 




RET 




^fin DAT£ Tn rAii_cp 




02740 


; utifttiinitiutintitmititiHtmitiiimtHtttitu 




02750 


; ROUTINE TO 


ACCEPT DATA FOR INPUT TO DISPLAYED MEMORY 




02760 


; LOCATIONS, 


WITH EXIT TO MENU UPDATE OR MEMORY INCREMENT 




0277C 


; mmmttttmmtmmummmmmtmmmtt 




02780 


; 








31 6E CDC331 


02790 


DATMOD 


CALL 


INPUT 


GET CHAR. FROM KEYBRD. 


3171 FE2E 


02800 




CP 


' . ' 


IS IT A PERIOD? 


3173 CAB031 


02810 




JP 


Z.ADEXIT 


IF SO, EXIT TO ADDR MOD 


3176 FEOD 


02820 




CP 


ODH 


IS IT A CARRIAGE RET? 


3178 2B2F 


02830 




JR 


2.NEXTD 


IF SO, GO TO NEXT DATA 


31 7A FE30 


02840 




CP 


'0' 


BEGIN TESTING FOR RANGE 


317C 3BF0 


02850 




JR 


C, DATMOD 


BACK IF <0 CHARACTER 


317E FE67 


02860 




CP 


B7H 


CHECK AGAINST LC ALPHA 


3180 30EC 


02870 




JR 


NC, DATMOD 


IF >F THEN GO BACK 

Listing Continued . . 
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It was natural that Radio Shack would choose 
an inexpensive storage medium, cassettes, to 
accompany their low cost microcomputer. 
Because ordinary cassette players are audio 
devices, the tape saving and loading routines 
were designed to be slow but sure. With care, the 
CTR series of recorders can be as reliable as any 
other storage system designed for the TRS-80. 

The weakness of the tape process comes from 
the obvious mismatching of an audio device, of 
very limited precision, with a digital device of 
unyielding high-precision. Portable cassette 
recorders are intended to reproduce audio signals 
with a reasonable level of fidelity. What 
constitutes a reasonable level of fidelity is 
disputable, and only a person with a true tin ear 
would not be able to pick out a portable player, 
from amongst a group of high fidelity tape decks. 

But even with this 'reasonable' fidelity, much 
of what we recognize as harmonies and 
instrumentation is perceptible only because we 
already have an acculturated comprehension of 
sound; and this directly influences what we 
believe we are hearing. Our minds, in 
conjunction with our ears - average, fill in, 
smooth over and forgive minuscule failings. We 
have internal mechanisms which remember our 
experiences. 

The cassette load/save system consists of 
seven major elements: 



1. Serialization. 

The individual bytes of computer data are 
converted into a stream of individual bits. 
This is a completely digital process, and the 
timing is provided by the computer. 

2. Audio Processing. 

The signal is converted into a 'digital audio' 
wave for recording on tape decks of unknown 
polarity. In other words, a digital, one to zero, 
signal is converted to an audio, one to minus 
one to zero, signal. In this way, an 'upside 
down' signal looks the same to a computer as 
the original. 



3. Recording. 

The signal goes through the tape recorder's 
electronics, and is recorded on a thin strip of 
magnetic tape. The audio electronics round 
the wave's edge, and the limitations of the tape 
contribute noise to the signal. 
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3182 
3164 
31 86 
318B 
31 BA 
318D 
31BE 
318F 
3192 
3193 
3195 
3197 
3199 
319A 
319D 
319E 
31 9F 
31A2 
31A5 
31A6 
31A7 
31A9 
31AC 
31AF 
31 BO 
31B3 
31BB 
31B7 
3188 
31BB 
31BD 
31C0 



FE3A 

3804 

FEB1 

38E4 

210A3F 

FS 

7E 

32093F 

F1 

FEBO 

3802 

0B20 

77 

CD4E31 

7C 

F5 

21063F 

CD4331 

F1 

77 

1807 

21 B63F 

CD4331 

23 

11003F 

CD1731 

1C 

7E 

CD2431 

18B1 

210B3F 

C30B31 



31 C3 
31C6 
31C9 
31CB 
31CC 
31CD 
31CE 
3100 
31D1 
3102 
31D3 
3105 
3106 
31 OB 
31 DA 
31 DC 
31DD 
31DE 
31 EO 
31 E1 
31E3 
31 E4 
31 E7 
31 EB 
31E9 
31 EB 
31EE 
31 EF 
31F2 
31F4 
31F6 
31F7 
31F9 
31FB 
31FC 
31FE 
31FF 
3202 
32U3 
3204 
32U5 
3206 
3207 
3208 
3209 
3208 
320C 
3200 

32DF 

3210 
3212 
3214 
3217 



21 3640 

01013B 

1600 

OA 

5F 

A3 

2018 

77 

14 

2C 

CB01 

79 

D680 

20F1 

0607 

2D 

86 

10FC 

A7 

3E00 

CO 

321A40 

C9 

A6 

281 B 

3A1A40 

3C 

321A40 

FEFF 

2B0B 

C5 

06FF 

1CIFE 

C1 

1BD3 

3D 

321A40 

7B 

73 

7A 

07 

07 

U7 

57 

0E01 

79 

A3 

2005 

14 

CB01 

1BF7 

3ABD3B 

47 



028 BO 
02890 
02900 
02910 
02920 
02930 
02940 
02950 
02960 
02970 
029B0 
02990 
03000 
03010 
03020 
03030 
03040 
03050 
03 060 
03070 
03080 
03090 
03100 
03110 
03120 
03130 
03140 
03150 
031BO 
03170 
03180 
03190 
03200 
03210 
03220 
03230 
03240 
03250 
03260 
03270 
03280 
03290 
03300 
03310 
03320 
03330 
03340 
03350 
03360 
03370 
033B0 
03390 
03400 
03410 
03420 
03430 
03440 
03450 
03460 
03470 
03480 
03490 
03500 
03510 
03520 
03530 
03540 
03550 
03560 
03570 
03580 
U359D 
03600 
03610 
03620 
03630 
03640 
03650 
03B60 
03670 
036B0 
03690 
03700 
03710 
03720 
03730 
0374O 
03750 
03760 
03770 
03780 
03790 
03800 



CP 

JR 
CP 
JR 

INOATA LD 

PUSH 

LD 

LL) 

POP 

CP 

JR 

SUB 

ZIPZY LD 

CALL 

LD 

PUSH 

LD 

CALL 

POP 

LD 

JR 

NEXTD LD 

CALL 
INC 

EXIT1 LD 

CALL 
INC 
LD 
CALL 

jn 

ADEXIT LD 
JP 



C, INOATA 

61H 

C.DATMOD 

HL.3F0AH 

AF 

A,[HL) 

13F09H) ,A 

AF 

60H 

C, ZIPZY 

2DH 

[HL],A 

AX2 

A,H 

AF 

HL.3F06H 

ASCHEX 

AF 

(HL),A 

EXIT1 

HL,3F06H 

ASCHEX 

HL 

DE.3F00H 

WORDER 

E 

A,(HL) 

HEXASC 

DATMOD 

HL.3FD6H 

NUM2 



TEST FOR NUMERIC >9 
IF <9 THEN GET DATA 
TEST FOR ALPHA <A 
IF <A THEN GO BACK 
READY THE SCREEN FTP. 
SAVE VALUE FROM KEYBRD 
GET LOWER ASCII NYBBLE 
AND PUT IN HIGH POS'N 
RESTORE VALUE FROM KBD 
CHECK AGAINST LC ALPHA 
IF LC, THEN SKIP PAST 
ELSE CONVERT TO U.C. 
AND DISPLAY ON SCREEN 
SINGLE BYTE CONVERSION 
SAVE ONE BYTE IN A REG. 
SAVE THAT NOW ON STACK 
POINT HL TO SCREEN POSN 
EVALUATE ADDRESS THERE 
RESTORE VALUE TO SHOW 
AND PUT ON THE SCREEN 
NOW GO OUT AND STORE 
POINT HL TO SCREEN POSN 
CONVERT ADDRESS TO HEX 
MOVE OVER TO NEXT POSN 
POINT DE ADDR. DISPLAY 
AND CONVERT/DISPLAY IT 
GO TO NEXT SCREEN POSN 
GET VALUE FROM MEMORY 
AND CONVERT FOR DISPLAY 
AND BACK FOR SOME MORE 
POINT TO PRESENT ADDR. 
AND BACK TO UPDATE MENU 



HtllHtHIMilttttitHiHHHIttttHilltllHItiilllll 

COMPLETE KEYBOARD ROUTINE BELOW MAY BE CALLED BY NOT 
ONLY THE MONITOR ROUTINES, BUT ANY ROUTINES NEEDING AN 
UPPER/LOWER CASE, AUTOREPEAT, BEEP DRIVER. FOR FURTHER 
DESCRIPTION, SEE SUPPLEMENT TO CHAPTER ON KEYBOARD I/O 

####««#####*##*#f**#####f ####*####«#*##*##«###«#*###### 

SAME AS LII BUFFER 
FIRST KEYBOARD ROW 
COUNTER FOR COLUMNS 
RETRIEVE ROW CONTENTS 
SAVE IT TEMPORARILY 
SET FLAGS FOR TESTING 
NOT ZERO IF KEY PRESSED 
SAVE CURRENT VALUE 
INCREMENT ROW COUNTER 
INCREMENT STORAGE ADDR. 
GET NEXT KEYBOARD COL. 
GET VALUE INTO ACCUM. 
LAST ROW IS 3880 HEX 
NEXT CHECK IF NOT DONE 
COUNTER OF KEYBRD ROWS 
START COUNTING BACKWARD 
AND ADD IT UP IN ACCUM. 
AND DO IT FOR 7 ROWS 
TEST FOR ANY KEY DOWN 
A=D, FLAGS ARE INTACT 
BACK IF KEYS IN USE 
ELSE DELAY GETS RESET 
AND GO BACK ANYWAY 
CHECK KEYSTROKE STORAGE 
NEW KEY IF NOT SAME ONE 
NEW CHECK SPECIAL STORE 
LET STORE = STORE + 1 
AND PUT IN BACK THERE 
CHECK IF IT IS AT END 
IF SO, THEN HOLD THERE 
SAVE ROW COUNTER REG. 
GET DELAY VALUE INTO B 
AND DELAY JUST A BIT 
RESTORE ROW COUNTER 
AND BACK TO CHECK NEXT 
LET A = A - 1 (STORE) 
AND PUT IT IN STORAGE 
GET KEYBOARD BYTE BACK 
IHD.E ; STORE IT IS STROKE AREA 

GET ROW COUNTER FROM D 
AND BEGIN PROCESS OF... 
...CONVERTING IT... 
...TO. AN OFFSET VALUE 
AND PUT IT BACK IN 
GET NUMBER ONE READY 
; ACCUM. HAS C FOR MASK 
TEST IF C = KEYSTROKE 
IF NOT, THEN GO AROUND 
ELSE D = BOW + COLUMN 
C SET TO NEXT COLUMN 
GO BACK AND TEST AGAIN 
GET SHIFT ROW FOR TEST 
AND SAVE IT IN B REG. 

Listing Continued . . . 



LD 


HL.4036H 


LD 


BC.3B01H 


LD 


D,0 


LU 


A.(BC) 


LD 


E,A 


AND 


E 


JH 


NZ, STROKE 


LD 


(HL),A 


INC 


D 


INC 


L 


RLC 


C 


LD 


A,C 


SUB 


BOH 


JR 


NZ.KEYPRS 


LD 


B,7 


DLL 


L 


ADD 


A,(HLJ 


DJNZ 


CLRMEM 


AND 


A 


LU 


A,0 


RET 


NZ 


LD 


(KPLACE),A 


RET 




AND 


[HD 


JR 


Z, FOUND 


LD 


A.IKPLACE] 


INC 


A 


LD 


IKPLACE1.A 


CP 


OFFH 


JR 


Z.DECA 


PUSH 


BC 


LD 


B.OFFH 


DJNZ 


TMWSTE 


POP 


BC 


JR 


RECHEK 


DtC 


A 


LD 


IKPLACE),A 


LU 


A,E 


LD 


IHD.E 


LD 


A,D 


RLCA 




RLCA 




RLCA 




LD 


D,A 


LD 


C,1 


LD 


A,C 


AND 


E 


JR 


NZ, AROUND 


INC 


D 


RLC 


C 


JR 


BACKUP 


LD 


A,(3880HJ 


LD 


B,A 



4. Storage. 

The tape sits on the shelf, affected by 
temperature and humidity, where its oxide 
coating may 'creep'. The tape may stretch or 
buckle or warp, and its upper and lower edges 
may become slightly feathered. 

5. Playback. 

The recorded signal, including warps, 
dropouts, feathering, creep and noise, is fed to 
the playback electronics. This audio circuit 
contributes further noise, providing a purely 
low grade audio signal to the computer. 

6. Digital Processing. 

The signal is received, its top and bottom 
edges are squared, and it is returned to the one 
to zero digital state. The timing is provided by 
the recorded tape in cooperation with timing 
loops provided by the computer. 

7. De-Serialization. 

A completed group of bits is assembled into an 
8 bit byte for use by the CPU in determining 
synchronization, type of program, loading 
location, etc. 



An oscilloscope representation of a digital 
signal being generated during the CSAVE 
routine is shown below. The signal changes from 
one to zero very crisply, spending only a few 
nanoseconds (not visible at all on the photo) in 
the transition area between one and zero. This 
true digital signal is measured just before the 
audio processing section sent to the cassette. 




The audio processing is actually no more than 
a digital signal whose polarity is reversed. Two 
outputs of a latch are tied together, and as one 
goes high, the other is forced low. Between 
pulses, the signal floats to the middle. This is 
done by data bits and 1 of Z59, which are 
alternately switched by the CPU during CSAVE. 
The digital signal as it leaves the cassette port is 
shown in the second photograph. 

The sharp edges of the signal have been ever so 
slightly blurred, partly due to the capacitance 
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3218 7A 

3219 C640 
321 B FE60 
3210 3016 
321F 57 

3220 3A403B 
3223 EE10 

3225 2009 
3227 7A 

3226 CB08 
322A 3830 
322C C620 
322E 1839 

3230 7A- " 

3231 0640 
3233 1834 
3235 0670 
3237 3010 
3239 C640 
323B FE3C 
323D 3802 
323F EE10 
3241 CB08 
3243 3024 
3245 EE10 

3247 1820 

3248 07 
324A CB08 
324C 3000 
3B4E 215832 

3251 4F 

3252 0600 

3254 09 

3255 7E 

3256 1811 

3258 sc- 
ans 0000 

3258 1F1F 
3250 0101 
325F 581 B 
3261 QAOO 
3263 0816 
3265 0919 

3267 2020 

3268 57 
326A 018001 
326D 08 
326E 78 
326F B1 
3270 20F8 

3272 7A 

3273 F5 

3274 0640 
3276 3A3D40 
3278 E6FD 
327B 67 
327C F602 
327E 6F 
327F 70 
3260 03FF 

3282 7C 

3283 D3FF 

3285 CB 

3286 0640 
3288 10FE 
328A C1 
328B 10F2 
326D F1 
328E CS 



32BF 7E 
3290 A7 
3281 CB 

3292 12 

3293 23 

3294 13 

3295 1BF8 



3297 3C 
32BB 3C 
32D4 8F 
3205 00 

32D6 5A 



03810 

03820 

03830 

03840 

03850 

03860 

03870 

03880 

03880 

03800 

03910 

03920 

03930 

03940 CNTROL 

03950 

03960 

03970 JUMP1 

03980 

03990 

04000 

04010 

04020 

04030 JUMPS 

04040 

04050 

04060 

04070 JUMP2 

04080 

04090 

04100 JUHP4 

04110 

04120 

04130 

04140 

04150 

04160 

04170 TABLET 

04180 

04190 

04200 

04210 

04220 

04230 

04240 

04250 GOAMAY 

04260 

04270 DELAYS 

04280 

04290 

04300 

04310 

04320 

04330 

04340 

04350 

04360 

04370 

04380 

04390 BEEPER 

04400 

04410 

04420 

04430 

04440 

04450 FREOCY 

04460 

04470 

04480 

04490 

04500 

04510 

04520 

04530 

04540 ; 

04550 DISPLY 

04560 

04570 

04580 

04590 

04600 

04610 

04620 

04630 

04640 

04650 

04660 

04670 

04680 

04690 MSG01 

04700 

04710 

04720 



LD 

ADD 

CP 

JR 

LD 

LD 

AND 

JR 

LD 

RRC 

JR 

ADD 

JR 

LD 

SUB 

JR 

SUB 

JR 

ADD 

CP 

JR 

XOR 

RRC 

JR 

XDR 

JR 

HLCA 

RRC 

JR 

LD 

LD 
LD 

ADD 
LD 

JH 

INC 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

LD 

LD 

DEC 

LD 

OR 

JR 

LD 

PUSH 

LD 

LD 

AND 

LD 

OR 

LD 

LD 

CUT 

LD 

OUT 

PUSH 

LD 

DJNZ 

POP 

DJNZ 

POP 

RET 



A,D 

A,40H 

60H 

NC.JUHP1 

D,A 

A,I3B40H) 

10H 

NZ, CNTROL 

A,D 

B 

C, GOAWAY 

A.20H 

60AWAY 

A,D 

40 H 

60AWAY 

70H 

NC.JUMP2 

A.40H 

3CH 

C.JUMP3 

10H 

B 

NC.GBAKAY 

10H 

GOAWAY 

B 

NC.JUMP4 

HL, TABLET 

C,A 

8,0 

HL.BC 

A,[HL) 

GOAWAY 

A 

ODODH 

1F1FH 

D101H 

1B5BH 

OOOAH 

1808H 

1909H 

2020H 

D,A 

BC.180H 

BC 

A,B 

C 

NZ, DELAYS 

A,D 

AF 

B,40H 

A,(403DH) 

OFDH 

H,A 

2 

L,A 

A,L 

(OFFH) ,A 

A,H 

10FFH1.A 

BC 

B.40H 

FREOCY 

BC 

BEEPER 

AF 



GET ROW COUNTER BACK 
AND CONVERT TO ASCII 
IS IT UP/LW/GRAFIX/CTRL 
GO OUT IF GRAPHICS 
SAVE PARTLY CONVERTED 
GET VALUE FOUND 7TH ROW 
CHECK IF DOWN ARROW 
IF SO, PRODUCE CONTROL 
ELSE GET VALUE BACK 
B BUMPS INTO CARRY FLAG 
IF CARRY, THEN SHIFT 
IF NOT THEN LOWER CASE 
AND GET OUT OF ROUTINE 
IF CONTROL CODE, GET IT 
GET RID OF ASCII MASK 
AND GET OUT OF ROUTINE 
THE BALANCE OF THE 

ROUTINE BELOW UP TO 
THE BEEP SECTION IS 
VIRTUALLY IDENTICAL 
TO THE KEYBOARD 
DETERMINATION SUB- 
ROUTINE FOUND IN 
ROM. THIS ENTIRE 
ROUTINE IS REPEATED 
BECAUSE IT CAN 
SERVE AS AN EXACT 
REPLACEMENT FOR 
THE LEVEL II BASIC 
ROUTINES WHEN [IF) 
THE ROMS HAVE BEEN 
REMOVED, REPLACED, 
DISABLED, ETC. 
SEE KEYBOARD ROUTINE 
RUNDOWN ELSEWHERE 

IN THIS BOOK 

CARR. RET. / CARR. RET. 
CLEAR SCRN / CLEAR SCRN 
BREAK KEY / BREAK KEY 
EDIT ESCAPE / UP ARROW 
NO CHANGE / LINEFEED 
BACKSP. LINE / BACKSP. 
32-CHAR MODE / HOR TAB 
SPACE / SPACE 
SAVE VALUE IN REG. 
DEBOUNCE VALUE AND 

IMPLEMENTED AT THIS 
POINT FOR ACTUAL 
KEYBOARD SCAN WHEN 
CHARACTERS ARE 
GET STORED VALUE BACK 
SAVE ACCUM. & FLAGS 
GET BEEP LENGTH VALUE 
GET STATUS OF SCREEN 
MASK SCREEN CHANGE 
STORE MSB IN H REG. 
SET BIT 1 TO BE ON 
STORE ALT. MSB IN L REG 
GET ALT. MSB TO OUTPUT 
AND OUTPUT RISING WAVE 
GET NORMAL MSB CHAR. 
AND OUTPUT FALLING WAVE 
SAVE NOTE LENGTH VALUE 
GET FREQUENCY DELAY 
AND WAIT A LITTLE WHILE 
NOW RESTORE LENGTH VAL. 
AND GO BACK THAT LENGTH 
RESTORE ORIGINAL CHAR. 
AND BACK TO CALLER 



n,tiiiimtinmitmiiitittttntintntuttiniitiii 

ROUTINE BaOW TAKES SIMPLE MESSAGES AND DISPLAYS THEM 

,ttttttnmniimtntmtiiimiiinutin>ititnnm 



LD 

AND 

RET 

LD 

INC 

INC 

JR 



A.IHL) 

A 

Z 

(DE).A 

HL 

DE 

DISPLY 



GET FIRST MSG CHARACTEH 
TEST IF OR CHARACTER 
BACK TO CALLING ROUTINE 
DISPLAY THE CHARACTER 
GET NEXT MSG CHARACTER 
GET NEXT DISPLAY POS'N 
AND TEST NEXT CHARACTER 



HUfittiitiiiituiiuntiimunniititnummini 

MESSAGES FOR OISPLAY FOLLOW. IN A STRIPPED SOFTWARE 

MONITOR CONFIGURATION, THESE MESSAGES HAY BE ELIMINATED 

AND DISPLAY PARAMETERS CHANGED ELSEWHERE IN THE LISTING 

fiii)tttttnntmntnttttttifittntnitiftnttnititt 




introduced by the cables and tape input. This is 
the first (and least significant) step in the 
extensive route of signal degradation. 



32F6 20 

3316 53 

3336 42 

3356 41 

3376 4E 

3396 41 

33B8 20 

33 DE 55 

33F6 53 

3416 45 

3436 28 

3456 4F 

3476 54 

3496 00 
3497 

0000 

ACHX 3163 
ADDMOD 30D7 
ADEXIT 31 BD 
AROUND 3214 
ASCHEX 3143 
AX2 31 4E 

BACKUP 320B 
BEEPER 327F 
CHECK 30CC 
CLEAR 303E 
CLRHEM 31 DC 
CLS 3D0C 

CNTROL 3230 
COLD 303C 
DATMOD 316E 
DECA 31 FE 
DELAYS 32ED 
DISPLY 328F 

EXEC 3110 
EXIT1 31 BO 
FOUND 3203 
FREOCY 3288 
GOAWAY 3269 
HEXASC 3124 
HXAC 3139 
INDATA 31 8A 
INPUT 31C3 



JUMP1 
JUMP2 
JUMP3 
JUMP4 



3235 
3249 
3241 
324E 



DEFM 
OEFM 
DEFB 
DEFB 
04730 MSG02 DEFM 



'<C>0LDSTART, <D>ISKBOOT, <M>ONITOR, 

'<U>SERJUHP, <W>ARMSTART? ' 

8FH 

00 

'Z80 REGISTERS AT MONITOR ENTRY: ' 



KEYPRS 31 CB 
KPLACE 401A 
LLLLS 31 5B 
L00P1 3051 
MENU 3022 
MDNTOR 306F 
MSG01 3297 
MSG02 32D6 
NEXTD 31A9 
NEXTX 3140 
NEXTZ 31 6B 
NUM2 31 OB 
NUMBER 30F8 
RECHEK 31 D1 
STROKE 31 EB 
TABLET 3259 
TMWSTE 31 F9 
USER 3058 
WARM 3064 
WORDER 3117 



04740 
04750 
04760 
04770 
04780 
04790 
04800 
04810 
04820 
04830 
04840 
04850 
04860 
04870 
04880 
04890 
04900 
02660 
01620 
03180 
037SO 
02440 
02510 
03730 
04390 
01520 
00640 
03430 
00310 
03940 
00620 
02790 
03630 
04270 
04550 
01880 
03120 
03660 
04450 
04250 
02110 
02320 
02920 
03280 
03970 
04070 
04030 
04100 
03310 
00160 
02600 
00730 
00440 
01080 
04690 
04730 
03090 
02360 
02710 
01860 
01770 
03360 
03510 
04170 
03600 
D0830 
00950 
01970 



OEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
OEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFB 
XXXXXX EQU 

END 



•SP= IX= IY= AF= ' 

>BC= DE= HL= RI= * 

'ALTERNATE REGISTERS AT MONITOR E' 
•NTRY [NOT USED IN LEV II BASIC):' 
'AF= BC= DE= HL= ■ 

■ ■ 

'USE PERIOD [.) TO ENTER AN ADDRE' 
'SS, SLASH [/) TO ENTER DATA. TO' 
'EXIT TO MONITOR MENU, TYPE STAR ■ 
'1*1, TO EXECUTE AT ADDRESS SHOWN' 
'ON SCREEN, TYPE EXCLAMATION POIN 1 
'T II) 
00 

s 



XXXXXX 3497 D4880 
ZIPBY 310A 01850 
ZIPZY 3189 03000 



02440 02510 02600 

01700 01720 01760 

02810 

03750 

01B60 01890 03050 03100 

03010 

03780 

04470 

01B7D 

00710 

03450 

01680 

03880 

00460 

01660 02850 02870 02910 03170 

0357D 

04300 

00430 01100 04610 

01640 

03080 

03520 

044S0 

03910 03930 03960 04040 04060 04150 

0156D 02010 02030 03160 

02170 02220 

02890 

00440 D1620 02790 

03840 

039BQ 

04010 

04090 

03410 

03490 03530 03550 03640 

02470 02540 

00750 

00550 

00500 

00410 

01080 

02630 

02330 

02680 

03190 

01740 

03620 

03340 

04100 

03600 

00520 

00540 

01150 01190 01210 01230 01250 01270 01290 

01340 01400 01470 01490 01510 01530 03130 

01830 
02980 
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The worst signal abuse takes place during the 
taping process. The reasonably digital signal is 
recorded with the poor electronics of a portable 
tape recorder, and the sharp-edged waves are 
rounded off by the natural limitations of the tape 
itself; examine Photo 6-4. Also visible in the photo 
are residual noise (tape hiss) and the high-frequency 
recording bias signal 

There is also an unexpected interreaction 
between the computer's output wiring and some 
tape recorders that produces a low-pitched hum, 
called a ground loop. The good data signal can 
ride on this ground-loop hum to result in sensitive 
volume settings — too high or low a volume during 
playback will cause the top or bottom of the digital 
waveform to travel out of the range of the digital 
processing. 

This digital processing redeems quite a bit of the 
audio signal, turning it back into a usable digital 
waveform much of the time. Photo 6-5 shows the 
results of the reshaping process; it's a fairly good 
signal that the CPU finally receives and must 
interpret as data. 

Now the names and descriptions of the seven 
CLOAD culprits: 



1. Head misalignment. This is the main 
cause of bad loads, because misalignment 
severely cuts the essential high frequencies. 
The CTR-80 already has a provision for adjust- 
rwOOing the playback head. If you have a CTR- 
41 (or other recorder), drill a hole directly over 
the playback head adjustment screw (under 

1. Head misalignment. This is the main cause 
of bad loads, because misalignment severely 
cuts the essential high frequencies. The CTR- 
80 already has a provision for adjusting the 
playback head. IfyouhaveaCTR-41 (or other 
recorder), drill a hole directly over the playback 
head adjustment screw (under the letters ERY 
in 'battery' on the CTR-41 face plate), and 
adjust with a small Phillips screwdriver. 

2. Speed variations. This one is not obvious, 
but note that a five percent variation in recorder 
speed can cause a bad load, especially with 
long BASIC lines during CLOAD. 

3. Bad tape. There is no reason to use low- 
grade tape, just as there is no reason to buy the 
best audio tape. Get a good commercial grade, 
and standardize with it 

4. Dirty head. Clarity and volume are cut 
down when the head is dirty. Clean it and all 
parts that contact the tape with isopropyl 
alcohol. 



5. Starting too soon. The beginning of most 
tape — especially leaderless tape — is often 
slightly crumpled, and data can be lost right at 
the start. Count off ten seconds. 

6. Magnetized head. Those who depend on 
cassettes will use the machine often, and the 
head will build up residual magnetism. Obtain a 
cassette demagnetizer (degausser) and use it 
often. 

7. Software. Early Level H BASIC ROMs 
have problems because the timing loops were 
not written ideally for low-grade audio use. 
These can be upgraded with new ROMs or the 
Radio Shack XRX cassette modification. 
Note, however, that removal of the XRX 
modification is necessary for use with high/low 
speed hardware modifications (except the 
Archbold 1981-82 kit). 




Photo 6-4. Rounded- off digital signal with tape hiss. 




Photo 6-5. Reshaped wave that the CPU finally sees. 
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Controlling the World 

The world is out there, waiting to be controlled 
by your TRS-80. Really. Most of the 
partly-mechanized daily routine that you find 
yourself doing by hand might be connected to the 
'80. Not that it should be, mind you, but it could 
be. You could successfully operate a clothes 
washer and drier, a dishwasher, an automatic 
furnace, an air conditioner, or many other 
electromechanical devices; turn lights, 
televisions, and radios on and off, as well as 
replace your ordinary wake-up alarm; dial the 
phone, or answer it in a synthetic voice; even act 
as a digital burglar alarm. But would you really 
want to? 

Admittedly, microprocessors are making their 
way into more and more appliances, including 
such diverse items as automobile engines and 
electric razors. But remember that the TRS-80 
is a spectacular general-purpose device; 
although it might do all sorts of control work, it's 
best suited to applications calling for a large 
library of different electronic tasks, most with 
crucial human interaction. Aside from machine 
- oriented tasks like word processing, 
calculating, and printing, then, these 
applications include (generally speaking) 
measurement, signalling, and cloning. 

Measurement involves the evaluation of a 
real-world occurrence in real time: checking 
temperature, counting events, comparing 
relative amounts of light or voltage or sound. 
Some of these measurements, like counting 



events, are inherently digital - an event (say, a 
person walking through a door) either is taking 
place or it isn't. A door is closed or it's open. And 
so on. Other measurements are relative or 
quantitative, consisting of small increments or 
continuous change, such as the pressure, the rate 
of flow, or the quantity of water in a pipe. 

Signalling is somewhat the opposite of 
measurement: a user is informed when some 
activity has been completed, or when a particular 
condition in the environment has been reached - 
including such things as the completion of a 
mailing list sort or someone breaking and 
entering. 

Cloning is a rather odd phrase, but it's what I 
would like to call the computer's ability to create 
precise duplicates of some target object or 
activity. If that sounds a bit too philosophical, 
then think of it this way: the computer is fast, 
which means if it is given a task, it can complete 
it quickly. The computer is capable of 
calculating the parameters of its task with 
enormous accuracy. And finally, the computer 
works in minute, definable, and identical 
increments. Simply stated, we can command a 
computer to do work which, barring glitches and 
bugs, will be identical every time. 

This last concept is the reason 
microprocessors have become the favored design 
tools for machining, measurement, and even the 
creation of music. Jigs wear out, so that 
tolerances change; but computer programs can 
be self-correcting. Measuring devices can go out 
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of alignment: again, computers can be 
programmed to cross-check and correct these 
errors. And finally, where electronic design has 
been sloppy as a result of inaccuracies in the 
electronic parts themselves (such as in 
synthesized music), computers can provide the 
advantages of precise replication where it was 
not possible before. 

The general approach to discrete, digital 
events is discussed in Chapter (?), where 
input/output ports are presented. The hardware 
of interfacing digital inputs and outputs to 
electrical appliances and other 'real-world' 
devices is brilliantly described in TRS-80 
Interfacing (Volumes 1 and 2 — see 
Bibliography; especially check Volume 2, 
Chapter 1). 

This Chapter will present a lew real-world 
interfacing projects, but will touch only lightly on 
the theory involved. If you plan to put together 
your own interfaces, turn to the references cited. 
Beyond that, here are some rules of thumb before 
you begin considering interfacing schemes or 
parts purchases: 

Output Interfacing 

TTL-level integrated circuits of the type used 
in your TRS-80 are capable of driving (running) 
little more than other TTL circuits like 
themselves or an occasional light-emitting diode 
(LED). Don't hook your computer expansion 
card onto any home-made electronic board 
unless it has TTL inputs; consider the 
computer's bus to be its most delicate hardware. 

For interfacing purposes, integrated circuit 
peripheral drivers are great. Use them to light 
small bulbs, turn on miniature relays, and to 
operate other low-voltage applications needing 
only limited current. Type 75452 is reliable and 
cheap, and takes abuse; it's the circuit used by 
the TRS-80 to run the video dot output and 
cassette relay. For LEDs, use individual 
transistors or the inexpensive type 500, 501 and 
502 digit and segment drivers. 

Isolation of hazardous voltages is essential for 
external equipment running from your 
computer. Consider anything plugged into 
house current to be potentially hazardous, 
because there's nothing like a power surge or 

unexpected short circuit to fry your '80 and 
maybe you too. Use opto-isolators and — or 
high-current relays for running electric stoves or 
even AC light bulbs. 

Always read the specifications of both the 
equipment you plan to interface and the device 



that's going to do the interfacing. Look for: 

- Average voltage and maximum voltage of 
the interfacing device, and operating voltage 
of the equipment to be run; the figure is 
given in volts (V), direct current volts 
(VDC), or alternating current volts (VAC). 
The interfacing device must always have a 
rating higher than the equipment to be run. 

- Average current and surge current of the 
the interfacing device, and operating current 
of the equipment to be run; the figure is 
given in amps (A) or milliamps (mA). The 
interfacing device must always have a rating 
higher than the equipment to be run. 

- Isolation voltage of the interfacing device. 
This device must have a rating roughly 67 
percent higher than the equipment to be 
run. 

Actually, interfacing peripheral equipment is 
one of the easiest things you can do with your 
TRS-80. Below is a simple schematic; it shows 
one latched output line from the computer, and 
how it might drive: 

(a) an LED 

(b) a relay 

(c) an ordinary house lamp 

(d) a motor 

(e) a high-voltage circuit. 

You wouldn't want to use this single line to do 
all these things, but you might want to combine 
the LED, house lamp, and motor. That way you 
could have an indicator near the computer that 
the motor is on, a bright lamp outside a building 

to indicate the motor is on, and the motor itself 
would go on. 

The point of this schematic is that it can be 
tapped at any point on the line of parts shown; 
use the parts only as far as you need them: 

Input Interfacing 

Counting events or determining occurrences 
has an easier group of rules: TTL level signals can 
interface right to other TTL devices with no 
work; just don't connect outputs together. 

Other on-off signals are interfaced with a 
device or group of devices which can shape the 
incoming signal into a neat, tight square wave, at 
TTL level. Such a device is called a Schmitt 

trigger, and is available as type 7414 for a few 
cents. 

If the signal is in the range of 4 to 7 volts, the 
Schmitt trigger will transform it to a fast-moving 
digital signal. If the signal occurs very often or is 
erratic or unstable in its rising voltage, then 
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F^ure 7-/. Methods for interfacing the TRS-80. 
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additional hardware or very tolerant software 
must be used. Use optical isolators to feed the 
computer or relays for interfacing higher 
voltages. 

For AC input, the signal may be transformed 
to about 3 to 6 volts, rectified to DC and filtered 
only if the signal is slow-moving (once a minute 
or so). Then the signal can be fed to a Schmitt 
trigger to the computer interface. Otherwise, the 
AC information can only be transformed to a 
lower voltage and its pulses (60 per second if it is 
ordinary house current) counted either by 
hardware or software. Don't interface AC if you 
can avoid it, because it can be a genuine pain in 
the bytes. Instead, have the AC run a fast relay 
and identify when the relay turns on and off. 



£H National 

dA Semiconductor 



A to D, D to A 



DAC0808, DAC0807, DAC0806 8 bit D/A converter 



general description 

The DAC0808 senes is an B-bit monolithic digital :o- 
analog convene' (DAC) featuring a full scale Output 
current settling time of 160 ns while dissipating only 
33 (nW with ±5V supplies. No reference current Oref) 
trimming is required for most applications since the full 
scale output current is typicallv ±1 LSB of 255 iREF> 
256 Relative accuracies of better than ±0.19% assure 
8 bt monotonicilY and linearity while zero level output 
current of less than 4 uA provides 8 bit lero accuracy 
to' IppF > 2 mA. The power supply currents of the 
DAC0808 senes are independent o* bit codes, and 
exhibits essentially constant device characteristics over 
the entire supply voltage range 

The DAC0808 will interface directly with popular TTL. 
DTL o' CMOS logic levels, and is a direct replacement 
tor the MC1508 MC1408 For higher speed applications 
see DAC0800 data sheet 



features 

■ Relative •ccuracy: ±0. 19% trror ro*tirnum 
(DAC0808J 

■ Full scale current match: ±1 LSB typ 

■ 7 and 6-bit accuracy available (DACO807. DAC08O6) 

■ Fast settling time: 150 ns typ 

■ Nonmvenmg digital inputs are TTL and CMOS 
compatible 

■ High SDeed multiplying input slew rate: 8 n*iA/u.s 

■ Power supp'y voltage range: i4.5V to ±t8V 

■ Low power consumption: 33 mW $ *5V 



block and connection diagrams 
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typical application 




FIGURE 1. :10V Output Difitel lo Analog Convener 



ordering information 





OPERATING TEMPERATURE 
RANGE 


ORDER NUMBERS' 




D PACKAGE (D16C> 


J PACKAGE U1«AI 


N PACKAGE (N 


8-tHl 


-56 C< T A <*I25°C 


DAC0808LD 


LM1506D-8 


DAcoeoeu 


LM150BJ-8 






1-tt.t 


0'C<T A <*75 L C 






0AC08O8LCJ 


LM14Q8J8 


DAC0806LCN 


LMUWN8 


7tn( 


C<T A < .;5"c 






0AC0B07LCJ 


LM1*08J-7 


OAC0807LCN 


LM14O0N 7 


6-b.t 


0'C<T A < «75°C 






DACOBOSLCJ 


LM1408J-6 


OACO0O6LCN 


IM 1408*6 



Note DflviCM may b* ordered by using either o'der numbe;- 



Signals from photocells and similar resistive 
devices can be fed through Wein bridges or 
merely fed into an operational amplifier. Again, 
the references such as TRS-80 Interfacing and 
Engineer's Notebook contain plenty of details on 
interfacing on-off signals. 

D-to-A and A-to-D Conversion 

Although some human events occur in on-off 
groups, most of life is pliable, elusive, and 
relative. It works by image and analogy, not by 
counting. It is an analog world, and the computer 
is a digital device. Faced with this dilemma, two 
important groups of electronic circuits have been 
developed: the digital-to-analog converter (D/A 
converter) and the analog-to-digital converter 
(A/D converter). 

The first class accepts a parallel digital input 
a given number of bits wide, and converts that to 
individual steps. For N steps, the number of 
distinct voltages or currents is 2 to the power N. 
The greater the number of bits, the lesser the 
relative size of the steps, to the point where the 
distinction between steps becomes insignificant. 
For an ordinary 8-bit data bus such as that on 
the TRS-80, the available voltage can be divided 
into 256 parts; for five-volt circuitry, this is 
0.0195 volts per step, starting at zero. If greater 
accuracy is essential, then 12-bit converters can 
be used (at greater expense), fed by one and one- 
half bytes of data from the computer. This 
provides 4,096 steps at 0.0012 volts per step. 
The most common 8-bit type is the DAC0808 
(National Semiconductor) or the MC1408L8 
(Motorola); data sheets are found in an 
Appendix. 

With present technology, conversion from 
analog signals to digital ones is much more 

application hints 

REFERENCE AMPLIFIER DRIVE AND COWPEN 
SATION 

The reference amplifier provides a voltage at pin M for 
converting the reference voltage to a current, and a 
turn-around circuit or current mirror tor feeding the 
ladder The reference amplifier input current, l^a. must 
always flow into pin 14, regardless of the setup method 
or reference voltage polarity 

Connections for a positive vo'tege are shown in Ftt,\/rt 7. 
The reference voltage source supplies the full curtnt 
1 14- For bipolar reference signals, as in The multiplying 
mode, R15 can be tied to a negative voltage corres 
ponding to the minimum input level- It is possible to 
eliminate R1 5 with only a small sacrifice in accuracy 

and temperature drift. 

The compensation capacitor value must be increased 
with increases in R14 to maintain proper phase margin; 
for R14 values of 1. 2.5 and 5 kn. minimum caoac-tor 
values are 15, 37 and 75 pF The capacitor may be tied 
to either Vjrg or ground, but using Vf.E increases 
negative supply rejection 



Figure 7-2. National Semiconductor data sheet example. 
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absolute maximum ratings cr A - 25°c unless otherwise noted, 




Power Supply Voltage 

V CC 5.5 V oc 
V EE -16 5 V 0C 
Dig.tal Input Voltage V5-V12 - 10 V c to + 18 V DC 
Applied Output Voltage Vq -1 1 Vrjc to +1B Vjx; 
Reference Current. I 14 5 mA 
Reference Amplifier Inputs. V14 V15 ^CC- Vfe 


Power DiMipation (Package Limitation) 

Cav.iy Package 1000 mW 
Derate above T A - 25 S C 6 7 mW/°C 

Operating Temperature Range 

DAC0808L -65'C < T A < ♦liFC 
DAC0808LC Series ^ T A < *75 c C 

Storage TemperBture Range HiS^C to +150' C 


electrical characteristics 








(Vcc= 5V. Vee s -15 V D C. VREF / RM-2mA. DAC0808L: T A " -55°C to +125X, DAC0808LC. DAC0807LC. 
DAC0806LC. Ta ~ = C to +75'C, and all digital inputs at high logic level unless otherwise noted.) 
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application hints [Continued! 

A negative reference voltage may be used if R14 n 
grounded and the reference voyage is app'ec to R15 as 
shown in Figure 8. A high inpur impedance is the ms.n 
advantage of this method Compensation invokes a 
capacitor to VfE on pm 16. us-ng the values of tha 
previous paragraph. The nog*! ve reference voitao*- must 
be at least 4V above the Vee supp-> Bipoia' >nput 
signals maY be handled by con-»ecTng R14 to a positive 
reference voltage equal to me peak positive input lave' 
at pin 15. 

When a DC reference voltage is used capaotve bypass 
to ground is recommended. Tne 5V log c suppv '* not 
recommended as a reference vo-tage If a wet regulated 
5V supply which drives log c s to be used as the refer 
ence, R14 should be decouped by connecting -t to 
5V through another resisto' a^c bypass<ng tne ,unct>on 
of the 2 resistors with 1 yF to g'Ound For reference 



voltages greater than 5V, a ciafp a^ode s recommended 
between pin 14 and ground 

If pin 14 is driven by a h-gr impedance sucr* as a 
transistor current source, no^e o* the aDovr co-n-ioensa 
tion methods apply and the a""p'.fie' must be heavily 
compensated, decreasing the o*era>! bano* width 

OUTPUT VOLTAGE RANGE 

The voltage on pin 4 is restr.ctes to a range of -0 6 to 
0.5V when V£E ■ -5V due ic the current swtchmg 
methods employed in the DAC0808 

The negative output voltage comp'iance of the DAC0808 
is extended to -5V where the negative supply voltage is 
more negative than -10V LH ng a full-scale current of 
1.992 mA and load resistor o* 2 5 kH between pm 4 
and ground will yield a vo'tage output of 256 levels 
between and —4.980V. Roatinfi, P ,n 1 does not affect 



the converter speed or powc d-&s<pat<on However, the 
value of the load resistor 6eie-m.nes the switching time 
due to increased voltage swng Values of R L up to 
500n do not significantly aHec: performance, but a 
2.6 kX2 load increases wo^sKase settling time to 
1.2 ms (when all bits are sw tcned 0N» Refer to The 
subsequent text section on Serii ng Time for more 
details on output loading 

OUTPUT CURRENT RANGE 



The output current maximum raung o f 4 2 mA may be 
used only for negative supo y voltages more negative 
than -7V due to the increased voltage drop across the 
resistors in the reference current ampMier 

ACCURACY 

Absolute accuracy is the meas«-e of each output current 
level with respect to its mtencec value, and >s dependent 
upon relative accuracy anc tu 1 -scale current drift. 
Relative accuracy is the measure of each output current 
level as a fraction of the fui<-sca> current The relative 
accuracy of the DAC0808 n essentially constant with 
temperature due to the nc* e p : temperature tracking 
of the monolithic resistor ladder The reference current 
may drift with temperature, causing a change in the 
absolute accuracy of output current However, the 
DAC08O8 has a very low full scale current drift with 
temperature. 

The DAC0808 senes is guaranteed accurate to within 
-1 ? LSB at a full-scale output current of 1.992 mA. 
This corresponds to a reference amplifier output current 
drive to the ladder network of 2 mA. with the loss of 
1 LSB (8 /jA) which is the ladde* remainder shunted to 
ground The input current to pm 14 has a guaranteed 
value of between 1.9 and 2.1 mA, ?llowing some mis- 
match m the NPN current source par. The accuracy test 
Circuit is shown in Figure 4 The 12-bit converter is 
caiib'ated for a full-scale output current of 1.992 mA. 
This is an optional step since the DAC0808 accuracy is 
essentially the same between 1.5 and 2 5 mA. Then the 
DAC0808 circuits' full-scale current is trimmed to the 
same value with R 14 so that a zero value appears at the 
error amplifier output. The counter is activated and the 
error band may be displayed on an oscilloscope, detected 
by comparators, or stored m a peak detector. 

Two 8 bit D:o-A converters may not be used to 
construct a 16-bn accuracy D-to-A converter 16-bn 
accuracy implies a total error of H/2 of one part in 
65.536. or rO. 00076%. which is much more accurate 
than the xO.019% specification provided by the 
DAC0808 

MULTIPLYING ACCURACY 



The DAC0808 may be used in the multiplying mode 
with 8-bit accuracy when the reference current is varied 
over a range of 256 1. If the reference current in the 
multiplying mode ranges from 16 /jA to 4 mA, the 
additional error contributions are less than 1.6 ^A. This 
is well withm 8*but accuracy when referred to full-scale. 

A monotomc converter is one which supplies an increase 
in current for each increment in the binary word 
Typically, the DAC0808 is monotonic for all values of 
reference current above 0.5 mA. The recommended 
range for operation with a DC reference current is 0.5 to 
4 mA. 

SETTLING TIME 



The worst-case switching condition occurs when all 
bits are switched ON, which corresponds to a low-to-high 
transition for all bits. This time is typically 150 ns 
for settling to within ±1/2 LSB, for 8-bit accuracy, 
and 100 ns to 1/2 LSB for 7 and 6-bit accuracy. The 
turn OFF is typically under 100 ns. These times apply . 
whan R L < BOOfi and Co < 25 pF. 

Extra care must be taken in board layout since this is 
usually the dominant factor in sansfactoy test results 
when measuring settling time Short leads, 100 u? 
supply bypassing for low frequencies, and minimum 
scope lead length are all mandatory. 
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complicated. Most commonly used is a 
technique which compares the input voltage to 
known voltages inside the converter. When a 
match is found, a binary version of the input 
condition is fed to the computer bus. This 
process is slow when compared to computer 
speeds, and such devices usually have 
start-of-conversion and end-of-conversion 
signals so the computer will not receive false data 
by attempting to read the converter's 
information during the conversion process. The 
commonly used 8-bit type is ADC0800 (National 
Semiconductor); see the Appendix. 

Music and Sound Effects 

There are other ways of producing sound using 
the TRS-80 which do not involve exclusively 
software. The software-only approach may be 
capable of producing sound effects, but in the 
TRS-80 configuration it cannot provide any 



spatial effects (it is monaural only), nor can it 
offer a large variety of textures. For these, the 
TRS-80 user must turn to a little extra 

hardware. 

Simplest among the extra hardware is a 
latched output address. The information 
written to the address appears at the output of 
the latch. Write to the address fast enough, and 
sound is produced, because the latch acts as a 
kind of electronic window to that single memory 
location. Feed that digital activity through a 
few resistors to blend the sounds, and run that to 
a stereo amplifier. Voila! Spatial sound. 

The circuit presented here contains an 8-bit 
latch (Zl), and address decoder (Z3, Z4 and Z4, 
mapped to 4FFF), and three-state output buffer 
(Z2). The computer data is latched into Zl when 
WRite to 4FFF appears at Z3/4/5. Depending on 
the data at Zl, any or all of the four buffers in Z2 
may be turned on or off. 
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Figure 7-3. Simple sound synthesis circuit 
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Figure 7-4. Alternate decoding scheme. 



An alternate decoding (8FFF) is provided, 
and is recommended for some of the musical 
selections presented. The selections include my 
own arrangement of 'God Rest Ye Merry 
Gentlemen', first presented in the Christmas 
1980 issue of 80 Microcomputing; and 'Your 
California', a suite by David Gunn, originally 
composed for viola duo. The latter group is 
written for use with the Exatron Stringy -Floppy, 
and will continuously repeat the four parts of the 
suite. 

There are two versions of the software; both 
are identical, except that the second is a two- 
voice program intended for pieces such as 'Your 
California'. Because the TRS-80 is slow (1.77 
MHz) and the Z-80 is slow (an enormous 
number of machine cycles per instruction when 
compared with other microprocessor families), 
four-part music will reproduce in the low 
register. The two-part music is much more 
satisfying musically. 







Figure 7-5. Music notation for people. 
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Figure 7-6. The same music for the computer. 
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10 REM • CLEARING SPACE FOR PROGRAM CHAINING SEQUENCE 
20 P0KE16634,PEEK{16634)+16 : REM • SIMPLE VARIABLE POINTER 
30 CLEAR50 : REM • CLEAR STRING SPACE AND RESET POINTERS 
40 SL0AD3 : REM * BRING NEXT PROGRAM IN FROM STRINGY FLOPPY 



10 0UT254.2 : CLS : PRINT"READING. . " : REM * 0UT254.2 = HISPEED 
20 X = 24578 : REM » THIS IS MEM. POSITION OF VOICE NUMBER ONE 
30 READ A : IF A = 999 THEN 50 ELSE POKE X,A : REM * EXIT • 999 
40 X = X + 4 : GOTO 30 : REM * VOICE APPEARS EVERY 4 MEM LOC'NS 
50 X = 24579 : REM • THIS IS MEM. POSITION OF VOICE NUMBER TWO 
60 READ A : IF A = 999 THEN 80 ELSE POKE X,A : REM * PITCH POKE 
70 X = X + 4 : GOTO 60 : REM * VOICE APPEARS EVERY 4 MEM LOC'NS 
BO X = 24576 : REM * THIS IS THE BEGINNING VALUE FOR DURATIONS 
90 READ A : IF A = 999 THEN 110 ELSE POKE X,A*2 : REM * RHYTHMS 
100 X = X + 4 : GOTO 90 : REM * NOTICE RHYTHM MULTIPLIER ABOVE 
110 RESTORE : REM • THIS GETS THE DATA POINTER BACK TO START 
120 X = 24577 : REM » THESE LOCATIONS USED FOR SUBTLE DURATIONS 
13D READ A : IF A = 999 THEN 15D ELSE POKE X,1 : REM * RHYTHMS 
140 X = X + 4 : GOTO 130 : REM » NO CHANGE IN LSB TIMING ABOVE 
150 POKE X,0 : POKE X+4,0 : POKE X+8,0 : REM • MUSIC END CODE 
160 0UT254.3 : POKE 16526,96 : POKE 16527,143 : M=USR(0) :CLEAR 
170 9L0AD4 : REM • PLAY NORM SPEED, USR CALL, CLEAR, LOAD NEXT 
180 OATAO, 0, 0, 0,0 ,0,0 ,0,22, 26 ,3D, 30,30,30 ,30,34, 34,34, D,D,D, 0,0 
190 DATA20, 16, 13, 14, 14,1 4,1 4, 14,1 5 ,15, 15,0,0 ,0,0 ,0,0, 20 ,18, 18 
200 DATA1 8, 18, 24, 0,24, 0,24, 0,24, 0,24, 24, 24 ,0,24, 0,24, 24, 0,24,0 
210 DATA24, 24, 0,24, 0,24, 24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24, 0,24,0 
220 DATA22, 22, 18, 16, 16, 16, 14, 14, 13, 13, 12, 13, 13, 13, 14, 19, 27, 19 
23D DATA13, 13, 14, 19, 27, 19, 13, 0,16, 0,20 ,0,22, 0,24, 0,24, 0,24, 0,24 
240 DATAO, 20, 16, 13, 14, 14, 20, 16, 13, 0,16, 0,1 6,0 ,16,1 2, 12, 12,1 2, 13 
250 DATA15,15,15,15,18,21 ,21 ,21,21,16,16,0,16,0,16,16,0,16,0,16 
260 DATA17.15 : REM * end of paye one for voice one 
270 DATA20, 21, 24, 26, 0,0 ,0,0 ,0,22, 26 ,30,30 ,30, 30, 30 ,34,34, 34, 0,0 
280 DATAO, 24,0, 24, 24, 24, 24,0, 24,0, 24, 24, 0,24,0, 24,0 ,0,0, 2D, 18 
29D DATA1B, 18, 18, 24, 0,24, 0,24, 0,21 ,0 ,22,0, 1B, 0,30,30 ,32,0 ,24,0 
300 DATA24, 0,24, 0,24, 0,26, 21 ,16,16,16,16,16,16,16,16,16,999 
310 REM » THIS IS THE END OF THE PITCH SEQUENCE FOR VOICE ONE 
320 DATA24, 0,24, 0,24, 0,24, 0,24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24,0 
330 DATA24, 0,24, 24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24, 24, 0,24, 0,26, 26 
340 DATAO, 26, 0,27, 0,27 ,0,27, 0,40, 0,22, 26 ,30, 30, 30 ,30, 30, 34, 34 
350 DATA34, 0,0, 0,0,0,0,20, 16, 13, 14, 14, 14, 14, 14, 15, 15, 15, 15, 0,0 
360 DATAO ,0,27, 3D ,32, 36, 40, 20, 18, 36, 40, 20, 18, 36, 40,20 ,18, 18, 36 
370 DATA36, 40, 20, 18, 18,36 ,36, 40 ,0,30 ,0,26, 0,32, 0,27,0, 27, 0,3D 
380 DATAD, 40 ,0,22, 22, 22, 26 ,30, 34, 34 ,34, 0,24, 0,24, 0,24, 24, 0,24 
390 DATAO, 24, 24, 0,24,0,24, 24, 0,24, 0,24, 26, 26, 26, 26, 22 ,30, 3D, 30 
400 DATA30,32,32,32 : REM * und of paye one for voice t*o 
410 DATA32, 32, 32, 0,0, 24, 0,24, 0,24,24,24, 0,24, 0,24, 24, 0,24, 0,24 
420 DATAO, 0,20, 16, 13, 14, 14, 14, 14, 14, 15, 15, 15 ,0,0, 0,24, 0,26, 26 
430 OATAO ,26, 0,27 ,0,27, 0,30,0 ,30 ,0,32,32, 32, 32,32,0 ,0,0,34,0 
440 DAT A34, 0,34, 0,34, 0,32, 28, 24, 24, 26, 24, 26, 24, 26, 28, 26, 999 
450 REM * this is the conclusion of the score for voice two 
460 DATA1 0,2, 2, 2, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2,3 ,3 ,3 
470 0ATA2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2 
480 DATA4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2,8, 2, 2, 2, 2,3 ,3 ,3, 2, 2, 2, 2,8, 2, 2, 2, 2 
490 DATA1 0, 2, 2, 2, 4, 4, 4, 4, 8, 8, 8, B, 8,8, 8, 8 ,8, 8, 4, 4, 4, 4, 8,8, 4, 4, 4 
500 DATA4, 10, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2,3 ,3 ,3, 8, 8,3 ,3 ,3 
510 DATA8, 10, 2, 2, 2, 8, 2, 2, 2, 2, 8,2,2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8 
520 DATA2,2,2,2,8,8,8 : REM * end of pege one for durations 
530 DATA8, 8, 16, B, B, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10 ,2, 2, 2, 3, 3 
540 DATA3, 2, 2, 2, 2, 8,2,2,2,2, 10, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2 
550 DATA2,10,2,2,2,2,2,4,8,10,2,2,2,10,2,2,2,4,4,B,B,1 ,1,1,1,3 
56D DATA6,20,999 : REM • end of score for durations; end 6core 



Listing 7-1. Examples of music programs. 



More Music 

Naturally, there is much more to the creation 
of music by computer than the mere sounding of 
tones; the appearance of commercial 
music-generation peripherals for the TRS-80 
attests to that. But though they may be 
well-designed pieces of electronics, composers 
and others serious about producing listenable 
music tend to look for richer sounds and more 
flexible ways to change that sound. 

There are several ways to do this. The simplest 
is the tone generator with a tempered scale, 
capable of producing chordal sounds (consisting 
of three or more pitches sounding 
simultaneously). The tone color is limited to a 
fixed palette, and they are suitable for making 
elementary music. I refer to these generically as 
'organs' because their tone colors usually give the 
illusion of organ stops. Most TRS-80 compatible 
music boards are simplified variations on the 
basic electronic organ, using integrated circuit 
chips like the General Instrument AY-3-8910 
and the Texas Instrument SN76489. 

A second group of electronic instruments 
creates music by constructing waveforms from a 
pre-assigned table of values. Thus, tone color, 
pitch, and volume can be altered by the selection 
of parameters in the table. This is digital 
synthesis in an elementary form, just one step 
beyond the simple software tone generation 
presented earlier in this Chapter. The TRS-80 is 
not capable of operating either with enough 
speed or electronic flexibility for digital 
synthesis. 

Peripheral to the digital synthesis of tones is 
the electronic creation of vocal sounds. Texas 
Instruments, Votrax and other integrated 
circuits use a complex algorithm called 'linear 
predictive coding' to select from a known subset 
of human vocal sounds. Although somewhat 
convincing voices can be produced this way, mere 
intelligibility is the least significant criterion in 
music. Until (and if) predictive devices are 
developed for a wide array of musical sound, they 
have no application for producing music. 

The most popular electronic music makers for 
more than a decade have been the analog 
synthesizers. Traditional oscillators create a 
sound which can be mutated and transformed 
until its color is right. These synthesizers were 
never conceived in computer-compatible terms, 
but companies such as PAIA have for the past 
few years offered hybrid analog-digital systems 
where the computer is used as a super-sequencer, 
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keeping the notes in order for storage and 
playback. 

There are several reasons why I suggest 
interfacing analog synthesizers to the TRS-80. 
First, analog synthesizers are cheap. Small, 
capable machines can be picked up for the cost 
of a TRS-80, and kits are sold by PAIA and 
others for less than $100. Surplus synthesizers 
are also available (Moog, Buchla, PBI, Putney, 
and others of early 1970's vintage) at low cost. 
All of these will take on new musical life when 
interfaced to the TRS-80. 

Second, if you are a performing musician, it's 
likely you're looking for a musical instrument, 



and it's in that area where the analog synthesizer 
is still champion. They are performance 
instruments, not electronic widgets. And with a 

computer interface, they remain stand-alone 
performance instruments, but with computer 
assistance where it is wanted. 

Figure 7-7 presents the circuit for a 2- to 
32-voice analog synthesizer interface. The basic 
circuit contains a data-line buffer (Zl), a buffer 
for the most used addresses (Z4), a port decoder 
and a voice-pair selector (Z2/Z3). In a fully 
expanded system, sixty-four ports (port 64 to 
port 127) are used to provide thirty-two voltage 
outputs, sixty-four envelopes, with sixty-four 
additional control lines. 
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10 OUT 254,2 : CLS : PRINT"READING. ." : HEM 0UT254.2 = HISPEED 
20 X = 24578 : HEM • THIS IS MEM. POSITION OF VOICE NUMBER ONE 
30 READ A : IF A = 999 THEN 50 ELSE POKE X,A : REM • PITCH POKE 
40 X = X + 4 : GOTO 30 : REM » VOICE APPEARS EVERY 4 MEM LOC'NS 
50 X = 24579 : REM • THIS IS MEM. POSITION OF VOICE NUMBER TWO 
60 READ A : IF A = 99E THEN 80 ELSE POKE X,A : REM • PITCH POKE 
70 X = X + 4 : GOTO 60 : REM * VOICE APPEARS EVERY 4 MEM LOC'NS 
BO X = 24576 : REM • THIS IS THE BEGINNING VALUE FOR DURATIONS 
90 READ A : IF A ■ 999 THEN 110 ELSE POKE X,A*2 : REM * RHYTHMS 
100 X = X + 4 : GOTO 90 : REM » NOTICE RHYTHM MULTIPLIER ABOVE 
110 RESTORE : REM * THIS GETS THE DATA POINTER BACK TD START 
120 X = 24577 : REM • THESE LOCATIONS USED FOR SUBTLE DURATIONS 
130 READ A : IF A = 999 THEN 150 ELSE POKE X,1 : REM • RHYTHMS 
140 X = X + 4 : GOTO 130 : REM * NO CHANGE IN LSB TIMING ABOVE 
150 POKE X,0 : POKE X+4,0 : POKE X+B.O : REM • MUSIC END CODE 
160 0UT254.3 : POKE 16526,96 : POKE 16527,143 : M=USR(0) :CLEAR 
170 8L0AD4 : REM » pLAY NORM SPEED, USR CALL, CLEAR, LOAD NEXT 
180 DATAO, 0,0, 0,0, 0,0, 0,22, 26, 30 ,30, 30, 30 ,30, 34 ,34,34, 0,0, 0,0,0 
190 0ATA20, 16, 13, 14, 14, 14, 14, 14, 15, 15, 15, 0,0, 0,0, 0,0, 20, 18, 18 
200 DATA1 8, 18,24, 0,24, 0,24, 0,24, 0,24, 24, 24, 0,24, 0,24, 24, 0,24,0 
210 DATA24, 24, 0,24, 0,24, 24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24, 0,24,0 
220 DATA22, 22, 18, 18, 16, 16, 14, 14, 13, 13, 12, 13, 13, 13, 14, 19, 27, 19 
230 DATA13, 13, 14, 19, 27, 19, 13, 0,16, 0,20, 0,22, 0,24, 0,24, 0,24,0 
240 DATA24, 0,20, 16, 13, 14, 14, 20, 16, 13, 0,16, 0,16, 0,16 ,12, 12, 12, 12 
250 DATA13,15,15,15,15,18,21 ,21,21 ,21 ,16,16,0,16,0,16,16,0,16,0 
260 0ATA16,17,15 : REM » END OF PAGE ONE FOR VOICE ONE 
270 0ATA20, 21, 24, 26 ,0,0, 0,0, 0,22, 26 ,30 ,30, 30, 30 ,30, 34 ,34 ,34, 0,0 
2B0 DATAO, 24, 0,24, 24, 24,24,0, 24,0, 24, 24,0, 24,0, 24,0 ,0,0, 20 ,18 
290 DATA18, 18, 18, 24, 0,24, 0,24, 0,21 ,0,22,0,18,0,30,30,32,0,24,0 
300 DATA24, 0,24, 0,24, 0,26, 21 ,16,16,16,16,16,16,16,16,16,999 
310 REM END OF PAGE TWO FOR VOICE ONE 

320 DATA24, 0,24, 0,24, 0,24, 0,24, 24, 24, 0,24, 0,24, 24, 0,24,0, 24,0 
330 DATA24, 0,24, 24, 24, 24, 0,24, 0,24, 24,0, 24, 0,24, 24, 0,24, 0,26 
340 DATA26, 0,26 ,0,27, 0,27, 0,27 ,0,40 ,0,22, 26 ,30, 30 ,30, 30, 30, 34 
350 DATA34,34,0 ,0,0 ,0,0, 0,20, 16, 13,14,14, 14,14,14,15,15,1 5, 15 
360 DATAO, 0,0, 0,27, 30, 32, 36, 40, 20, 18, 36, 40, 20 ,18, 36, 40, 20, 18, 18 
370 0ATA36, 36, 40, 20, 18, 18, 36 ,36, 40 ,0,30 ,0,26, 0,32, 0,27 ,0,27,0 
380 DATA30, 0,40, 0,22, 22, 22, 26 ,30, 34 ,34 ,34, 0,24, 0,24, 0,24, 24,0 
390 0ATA24, 0,24, 24, 0,24,0, 24, 24, 0,24, 0,24, 26, 26, 26, 26, 22 ,30, 30 
400 0ATA30, 30,32,32, 32 : REM • END OF PAGE ONE FOR VOICE TWO 
410 DATA32.32, 32, 0,0, 24, 0,24, 0,24, 24, 24, 0,24, 0,24, 24,0, 24, 0,24 
420 DATAO, 0,0, 20 ,16, 13, 14, 14, 14, 14, 14, 15, 15, 15, 0,0, 0,24, 0,26, 26 
430 DATAO, 26, 0,27, 0,27, 0,30 ,0,30 ,0,32,32, 32, 32,32,0, 0,0, 34, 0,34 
440 DATAO ,34, 0,34, 0,32, 28, 24, 24, 26, 24, 26, 24, 26, 28, 26, 999 
450 REM • END OF PAGE TWO FOR VOICE TWO 

460 DATA10, 2, 2, 2, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2,3 ,3 ,3 
470 DATA2, 2, 2, 2, 8, 2, 2, 2, 2, 8,2, 2, 2, 2, 8,2, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2 
480 DATA4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8,2,2,2, 2, 3 ,3 ,3, 2, 2, 2, 2, 8, 2, 2, 2, 2 
490 DATA1 0,2, 2, 2, 4, 4, 4, 4, B, 8,8, 8, 8, 8, 8, 8, 8, 8, 4, 4, 4, 4, 8, 8,4, 4, 4 
500 DATA4, 10, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2, 3, 3,3 ,8, 8,3 ,3 ,3 
510 DATAB, 10, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, B, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2 
520 DATA2,2,2,8,8,8 : REM * END OF PAGE ONE OF RHYTHMS 
530 DATA8, 8, 16, B, 8, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2,3 ,3 
540 DATA3, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2 
550 DATA2, 10, 2, 2, 2, 2, 2, 4, 8, 10, 2, 2, 2, 10, 2, 2, 2, 4, 4, 8, 8,1 ,1 ,1,1,3 
560 DATA6,20,999 : REM • END OF RHYTHMS PAGE TWO AND END PIECE 



Each pair of voices is managed by 
programmable peripheral interface Z5, which 
provides two 8-bit outputs to digital-to-analog 
converters Z6 and Z7, offering one-part-in-256 
accuracy. Remaining from Z5 are eight control 
lines for envelope, etc. Optionally, six of these 
remaining control outputs can be used for 
voltage control of volume or filtering (see Figure 
7-7 ), which can be used with less resolution 
(one part in 64) than that needed for pitch 
control. 

Figure 7-8 is the power supply, which is 
similar to others in this book with the exception 
of the LM340-8, providing eight volts as a 
reference to the digital-to-analog converters. 

The output of the D/A converters Z6 and Z7 is 
in the range of volts to 4.98 volts, which should 
be more than adequate to drive most 
synthesizers across their full range. The 
envelope triggers provided by Z8 and Z9, 
however, may need tweaking depending on the 
type of synthesizer you are using. Some synthos 
require a negative-going pulse, and others need a 
positive-going one; likewise, some synthos trigger 
on the rising or falling edge of the wave, while 
other envelopes will sustain as long as the level of 
the trigger signal remains high or low. Thus, the 
resistance and capacitance values given for Z8 
and Z9 may have to be changed for sustained 
envelope triggers, or Z8 and Z9 might be 
eliminated completely if the envelope is 
edge-triggered. If you don't have specs on your 
synthesizer, build the trigger circuit up, then 
down, until it works for your machine. 
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Figure 7-8. Power supply for the synthesizer interface. 
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10 QUT254,2 : CIS : PRINT"READING. ." : REM » 0UT254.2 = HISPEED 
20 X = 24578 : REM » THIS IS MEM. POSITION OF VOICE NUMBER ONE 
30 READ A : IF A = 899 THEN 50 ELSE POKE X,A : REM * EXIT 6 999 
40 X = X + 4 : GOTO 30 : REM * VOICE APPEARS EVERY 4 MEM LOC'NS 
50 X = 24579 : REM » THIS IS MEM. POSITION OF VOICE NUMBER TWO 
60 READ A : IF A = 999 THEN 80 ELSE POKE X,A : REM • PITCH POKE 
70 X = X + 4 : GOTO 60 : REM * VOICE APPEARS EVERY 4 MEM LDC'NS 
80 X = 24576 : REM * THIS IS THE BEGINNING VALUE FOR DURATIONS 
90 READ A : IF A = 999 THEN 110 ELSE POKE X,A*2 : REM » RHYTHMS 
100 X = X + 4 : GOTO 90 : REM * NOTICE RHYTHM MULTIPLIER ABOVE 
110 RESTORE : REM * THIS GETS THE DATA POINTER BACK TO START 
120 X = 24577 : REM » THESE LOCATIONS USED FOR SUBTLE DURATIONS 
130 READ A : IF A = 999 THEN 150 ELSE POKE X,1 : REM • RHYTHMS 
140 X = X + 4 : GOTO 130 : REM * NO CHANGE IN LSB TIMING ABOVE 
150 POKE X,0 : POKE X+4,0 : POKE X+B,0 : REM * MUSIC END CODE 
160 0UT254.3 : POKE 16526,96 : POKE 16527,143 : M=USR[0) :CLEAR 
170 SL0AD6 : REM » PLAY NORM SPEED, USR CALL, CLEAR, LOAD NEXT 
180 DATAO, 0,0, 0,0, 0,0, 0,25, 29, 31 ,29,3,0,0,0,0,20,16,13,14,14,14 
190 DATA1 4, 1 4, 1 5, 1 5,1 5, D, 0,0, 0,0 ,0,20, 18, 18, 18, 18, 24, 0,24, 0,24 
200 DATAO, 24, 0,24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24, 24, 0,24, 0,24, 24 
210 DATA24, 24, 0,24, 0,24, 24, 0,24, 0,24, 0,24, 0,22, 22, 18, 18, 16, 16 
220 DATA14, 14, 13, 13, 12, 13, 13, 13, 14, 19, 27, 19, 13, 13, 14, 19, 27, 19 
230 DATA13, 0,16, 0,20, 0,22, 0,24, 0,24, 0,24, 0,24, 0,1 2, 12, 12, 12, 13 
240 DATA15,15,15,15,18,21 ,21 ,21 ,21 ,16,16,0,16,0,16,16,0,16,0,16 
250 DATA17.15 : REM * END OF PAGE ONE FOR VOICE ONE 
260 DATA3, 140 ,3, 22, 26 ,30 ,30, 30, 30, 30 ,34, 34, 34, 0,0 ,0,24, 0,24, 24 
270 DATA24, 24, 0,24, 0,24, 24, 0,24, 0,24, 0,0, 0,20, 18, 18, 18, 18, 24,0 
280 DATA24, 0,24, 0,21 ,0,22,0,18,0,30,30,32,0,24,0,24,0,24,0,24,0 
290 DATA26, 21 ,16,16,16,16,16,16,16,16,16,999 : REM » END P2V1 
300 DATA24, 0,24, 0,23 ,3, 135,1 ,1 ,42,0,24,0,24,0,24,24,24,24,0,24 
310 DATAO, 24, 24, 0,24, 0,24, 24, 0,24, 0,26, 26, 0,26, 0,27, 0,27, 0,27,0 
320 DATA40, 0,22, 26 ,30,30, 30, 30, 30, 34, 34, 34, 0,0, 0,0, 0,0, 20, 16, 13 
330 0ATA1 4, 14, 14, 14, 14, 15, 15, 15, 15, 0,0, 0,0, 27, 30 ,32, 36, 40, 20 
340 DATA1 8, 36, 40, 20, 18, 12, 140, 140, 13, 3, 40, 20, 18, 18, 36 ,36, 40,0 
350 0ATA30, 0,26, 0,32, 0,27, 0,27, 0,30, 0,40, 0,22, 22, 22, 26 ,30, 34 ,34 
360 DATA34, 0,24, 0,24, 0,24, 24, 0,24, 0,24, 24, 0,24, 0,24, 24, 0,24,0 
370 DATA24, 26, 26, 26, 26, 22, 30,30, 30, 30,32, 32, 32 : REM * END P1V2 
380 DATA32, 32, 32, 0,0, 24, 0,24, 0,24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24 
390 DATAO ,0,0, 20 ,16, 13, 14,1 4, 14, 14,14, 15,1 5,1 5,0 ,0,0, 24,0, 26, 26 
400 DATAO, 26, 0,27, 0,27 ,0,30,0 ,30,0,32,32,32,32, 32, 0,0,0, 34, 0,34 
410 DATAO ,34, 0,34, 0,32, 28, 24, 24, 26, 24, 26, 24, 26, 28, 26, 999 
420 REM * END OF PAGE TWO FOR VOICE TWO 

430 DA TA1 0,2, 2, 2, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2,3 ,3 ,3 
440 DATA2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2 
450 DATA4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2,3 ,3 ,3, 2, 2, 2, 2,8, 2, 2, 2, 2 
460 DA TA1 0, 2, 2, 2, 4, 4, 4, 4, 8, 8, 8, B,B,B, 8, 8,8,8,4,4, 4, 4, 8, 3, 11 ,5,4 
470 DA TA1 0,2, 2, 2, 10, 2,1 ,1 ,10 ,2,2,2,10,2,2,2,3 ,3 ,3 ,8,8 ,3 ,3 ,3,B 
480 DA TA1 0,2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2 
490 DATA2,2,8,8,8 : REM » END OF PAGE ONE OF RHYTHMS 
5U0 0ATA8, 8, 16, 8, 8, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2,3 ,3 
510 DA TA3, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2 
520 DATA2, 10, 2, 2, 3, 13, 5, 9, 2, 2, 2, 12, 10, 2, 2, 2, 4, 4, 8, 8,1 ,1 ,1 ,1 ,3,6 
530 DATA20,999 : REM * END PAGE TWO OF RHYTHMS AND END PIECE 



Synthesizer Interface Port Addressing 
Port Function 



Port Number 


Port Number 


(DBCimel) 


[Hex) 


64 


40 


BL 


41 


66 


42 


67 


43 


68 


44 


69 


45 


70 


46 


71 


47 


72 


48 


73 


49 


74 


4A 


75 


4B 


76 


4C 


77 


4D 


78 


4E 



124 


7C 


125 


7D 


126 


7E 



7F 



Pitch Control Voice 1 
Pitch Control Voice 2 
Envelopes 1 a/b and 2 e/b 
Extra Lines 1 a/b end 2 a/b 
Port Control Voices 1-2 
Pitch Control Voice 3 
Pitch Control Voice 4 
Envelopes 3 a/b end 4 a/b 
Extra Lines 3 a/b end 4 a/b 
Port Control Voices 3-4 
Pitch Control Voice 5 
Pitch Control Voice 6 
Envelopes 5 a/b end 6 a/b 
Extra Lines 5 e/b and 6 a/b 
Port Control Voices 5-6 
Pitch Control Voice 7 
Pitch Control Voice 8 
Envelopes 7 e/b and 8 a/b 
Extra Lines 7 e/b end 8 a/b 
Port Control Voices 7-8 



Pitch Control Voice 31 
Pitch Control Voice 32 
Envelopea 31 a/b and 32 e/b 
Extra Lines 31 a/b and 32 a/b 
Port Control Voices 31 - 32 



Table 7-1. Synthesizer interface port addressing. 

Using the synthesizer interface is 
straightforward. Plug the interface into the 
TRS-80 expansion connector, and run shielded 
microphone cable from the voltage outputs of 
the interface to the voltage inputs (marked 
'control in', 'voltage in', 'VCO control', 'external 
in', or something similar) on the synthesizer. 
Then run either parallel speaker wire or shielded 
cable from the interface envelope (positive-going 
edge) to the synthesizer's envelope inputs. The 
integrated circuits running from the interface 

are not balanced for long lines; if you plan to use 
more than a dozen feet of cable, place 7417 open- 
collector buffers at each control output from the 
interface, so: 



CD 
ID 



7417 
(PART) 




1 





SYSTEM 
POSITIVE 
VOLTAGE 
K30VJ 



<3r. 



SHIELDED CABLE 



SYNTHO 

TRIGGER 

BLOCK 
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Chapter 7 



More Music 



10 0UT254,2:CLS: PRINT "READING..." 

12 x=24578 

15 REAOA:IFA=99 9THEN3 0ELSEPOKEX,A:X=X*4:6 0T015 

30 X=24579 

3 5 READA:IFA=998THEN50Et.SEP0KEX,A:X=X+4:G0T035 

50 X=24576 

5 5 HEADA:IFA=899THEN80E1.SEPOKEX,A»2:X=X+4:GOT055 

60 REST0RE:X=245?7 

80 REA0A:IFA=999THEN97ELSEP0KEX,1 :X=X+4:G0T090 

97 0UT254,3 :PDKEX+4,0: POKEX+B , :P0KE1 6 526, 96 :P0KE1 6527 , 1 43 : H=USR [ ) : CLEAR 

98 «L0AD3 

100 DATA20, 20, 20, 20,20, 20,20,1b, 20, 19,17, 17, 17, 17,17,15 

110 0ATA24.24.21 ,27 , 26 ,27 ,27 , 27 ,3 0,27 ,3 ,27 ,0 ,0 ,20 ,21 ,20 ,19 , 1 7 

120 DATA16.1 6, 27, 24,40,46,40,44,40,36,30,26 ,26,18, 18,14,13 

130 OATA11 ,8,9,9,12,11 ,12,10 ,21 ,21 , 27 , 27 ,29 ,27 , 28 ,24 

140 DATA28 , 28 , 28 , 27 , 24, 1 8 , 17 ,17 , 20 ,13 ,13 ,18 , 16 ,20 ,21 ,21 , 24,22 , 22 , 22 ,20 

150 DATA18,19, 38, 27, 30, 30, 29, 36, 19, 19, 20, 20, 13, 13, 22, 22, 24, 24, 17, 15, 15 

160 DATA1 4,27 ,24,21 ,20,21 ,16,14,13,11 ,10,13 ,18,24 

170 DAT A3 2, 32, 32, 32, 32, 32, 32, 32, 32, 32, 32, 32, 32, 32, 30, 27, 40, 38, 38, 28, 28, 26, 24, 24 

180 DA TA20, 20, 20, 2D, 20, 20, 20, 18, 20, 18, 17, 17, 17, 17, 17, 15 

180 DATA2 4, 24, 21 ,27 ,26 ,27,27 ,27 ,30,27,27,24,22,3 2,3 2,24,22 

200 DATA34,34,32,42,42,38,3B,34,30,24 t 22,20,14 l 14 

210 DATA13, 13, 14, 16, 18, 18, 18, 17, 16, 20, 22, 26, 27, 27, 27, 30, 24, IB 

220 DA TA17, 17, 17, 17, 18, 16, 14, 13, 19, 22, 26, 27, 27, 27, 34, 28, 28, 22, 22, 22 

23 OA TA24, 2 4, 20, 3 0, 3 8, 3 B, 40, 3 8, 4 2, 4 2, 42, 44, 5 4, 6 8, 6 8, 6 B, 66,48,52, 44, 40 ,34,34,36 

240 REN END DF PAGE 1 

2 50 0ATA3B,44,3 2,3 2,3 4,40 , 28. 28, 30, 36, 26. 27, 32, 22, 24, 30, 32, 36, 3B, 42, 40, 36 
26 DA TA40 ,40,38,44,3 2,3 2,34,40,20,28,3 6,3 2,27,27,27,24,21 

270 DATA20, 20, 20, 20, 20, 20, 20, 18, 20, 19, 17, 17, 17, 17, 17, 15, 24, 26, 27, 30, 32, 34, 36,0 

280 DATA4Q ,0 ,0 ,0,0,0,0 ,0 ,0,999 

290 REM END OF PAGE 2 

300 DAT A6 0,52, 48, 40, 34, 36, 42, 60, 52, 46, 48, 40 ,34, 36, 42, 42 

310 DATA6 0,52, 48, 48, 40, 3 4, 36, 42, 42, 60, 52, 52, 48, 40 ,34, 34, 3 8, 3 6, 42 

3 20 DATA54, 52, 42, 38, 30, 32, 38, 54, 54, 52, 52, 42, 36, 30, 32,36,38 
330 0ATA54, 52, 42, 36, 30, 30, 32, 3B, 54, 52, 42, 36, 36, 30, 32, 38 

340 DATA4B,44,38,3 2,3 2,27,27 ,2B,2B,34,48,44,44,3B,3B,32,32,27,28,34,34 

3 50 DAT A46, 4B, 44, 44, 3 B, 3 2, 3 2, 27, 2B, 3 4, 48, 44, 44, 38, 3 B, 3 2, 3 2, 27 .27 ,26 ,34 

360 DAT A3 6, 36, 36, 36, 52, 52, 52, 64, 64, 64, 68, 68, 68, 68 

370 DA TA6B, 80, 60, 54, 42, 48, 40, 44, 52, 40, 54, 40, 57, 72, 7 6, 7 6, 44, 52, 57, 6 4, 48, 40, 54, 57 

3 BO DATA6 0.57 ,48, 40, 34, 36, 42, 60, 57, 48, 48, 40, 34, 36, 42, 42 
380 OAT A6 0, 57, 46, 48, 40, 34, 36, 42, 42, 64, 68, 76, 76, 4B, 38, 40, 40 
400 DATA40, 57, 54, 48, 6 0,6 4, 42, 52, 52, 52, 48. 54, 60, 6 B 

410 0ATA76, 72, 60, 52, 42, 44, 54, 54, 76, 76, 72, 72, 60, 52, 42, 44, 44, 54 

420 DATA40, 42, 52, 60, 60, 72, 72, 68, 66, 57, 57, 40, 42, 52, 52, 60, 60, 72, 6B, 57 

43 DATA36, 3 8, 3 B, 44, 44, 54, 54, 6 4, 6 4, 6 ,52, 52, 36, 36, 38,44, 54, 54, 64, 64, 60, 60, 52, 52 

440 REM END OF PAGE 1 

4 50 DATA54, 54, 54, 72, 48, 48, 48, 64, 42, 42, 40 ,38, 3B, 38,52,52,34, 34, 34, 34, 44, 44 

46 0ATA30,28,27 ,27, 27, 36, 24, 24, 24, 32, 21, 20, 19, 29, 42, 68, 6B 

47 DATA6 0,S7 ,46, 40 ,34, 36, 42, SO, 57, 48, 48, 40, 34, 36, 42, 42 

480 0ATA60, 57, 48, 44, 42, 0,0, 0,40, 0,0, 0,0, 0,0, 0,0, 0,0, 0,0, 0,0,888 

4S0 REM ENO OF PAGE 2 

500 DATAB.8,8,8 ,B,B,8,8,8,4,4,B,8,6,4,4 

510 0ATA8,8,4,4,B ,B,B, 4, 4, 8, 4, 4, 8, 8, 4, 4, 4, 4, 8 

5 20 DATAB ,B, 8, 8, 8, 8, 8, 4, 4, 4, 4, 8, 8, 8, 8,4, 4 
53 DATAB, 8, 8, 8, 4, 4, 8, 8, 8, 8, 8, 4, 4, B, 8, 8 

540 DAT A8, 8, 8, 4, 4, 4, 4, 4, 4, B, B, 4, 4, 4, 4, 4, 4, 8, B, 4, 4 

550 DATA4,4,4,4,B ,4,4,8,8,6,8,4,4,4,4,4,4,4,4,8,8 

56 DATA8 ,B,B,8,8,8,8,8,B,B,8,8,8,B 

570 DATA4,4,4,4,4,4,4,4,4,4,4,4,4,4,B,B,8,4,4,4,4,B,4,4 

580 DATAB, 8, 8,8, 8, 8, 8, 8,6,4,4,8, 8, 8, 4, 4 

5 80 DAT AB,B, 4, 4, B, 8, 6, 4, 4, 8, 6, 4, 4, 8, 6, 8, 6 

600 OAT AS ,B,8,8,8,B,B,B,B t 6,8,8,8,B 

610 DA TAB, B,B, 8, 8, B, 4, 4, 4, 4, 4, 4, 6, 8, 8, 4, 4, 8 

620 DATAB, B, 8, 4, 4, 4, 4, 4, 4, 4, 4, 8, 8, 4, 4,4,4,8,8,6 

63 DA TAB, 4, 4, 4, 4, 4, 4, 4, 4, B , 4, 4, 4, 4, B, 8, 4, 4, 4, 4, 4, 4, 4, 4 

640 REM END OF PATE 

650 DATA4, 4, 6, 6, 4, 4, 8, 8, 4, 4, B ,4, 4, 8, 4, 4, 4, 4, 4, 4, 4, 4 

660 DATA8,6,4,4,8,8,4,4,B,B t B,8,8,B,a,4 t 4 

670 DATAB, 8, 8,8 ,8, 6, 8, 8, 8, 4, 4, B, 8, 8, 4, 4, B, 6, 6, 8, 8, 4, 4, B 

680 DATAe,B,8,B,B,8,8,B,8B8 



10 GOSUB 650 : REM 
20 DEFINT V, A, B, 



30 V1 
40 V2 
50 EN 
60 TN 
70 TF 
BO CT 
30 PT 
100 NN 



64 

65 : 

66 : 
32 : 



67 
128 

200 



REM 
REM 
REM 
REM 
REM 
REM 
REM » 
REM 



• THE TUNING SECTION IS RETRIEVED FIRST 
C, 0, T, X, Y, P, N : REM • INTEGERS ALL 
VOICE ONE USES OUTPUT LOCATION 64 
VOICE TWO USES OUTPUT LOCATION 65 
ENVELOPE TRIGGER USES OUTPUT LOCATION 66 
TRIGGER TURNED ON WITH VALUE 32 
TRIGGER TURNED OFF WITH VALUE 
8255 PIA CONTROL REGISTER AT LOCATION 67 
1 PORT OUTPUT ONLY DEFINED BY VALUE 12B 
NUMBER OF NOTES DEFINED BY VALUE 200 
110 DIM V1 12,500) : REM * ARRAY OF NOTES AND THEIR DURATIONS 
120 DIM V212.500) : REM * ARRAY OF NOTES AND THEIR DURATIONS 
130 X=1 : REM » TEMPORARY COUNTER ONLY 

READ VI [1 ,X) : REM * READ VOICE ONE 

READ V1I2.X) : REM » REAO DURATION ONE 

IF V1I2.X] = THEN 170 ELSE X = X + 1 : GOTO 140 

: REM » TEMPORARY COUNTER ONLY 

READ V2(1,X) : REM » READ VOICE TWO 

READ V2(2,X) : REM • READ DURATION TWO 

IF V2I2.X) = THEN 210 ELSE X = X + 1 : GOTO 180 



140 

150 
160 

170 X=1 
180 

190 

:.jo 

210 A=1 



: B=1 : C=1 



D=1 



R=2 



X=1 : Y=1 : 0=0 
220 OUT CT,PT : OUT V1 ,255 : OUT V2.255 
230 G = V1(R,X] : H = V2(R,Y) : GOSUB 33D : GOSUB 350 

IF G <= Q THEN 250 ELSE 270 

GOSUB 330 : G = V1IR.X) 



240 G = G - A 

250 X = X + A 

260 GOTO 280 

270 FOR W = 1 TO 14 : NEXT 

280 H = H - A : IF H <= Q THEN 290 ELSE 310 

290 Y = Y + A : GOSUB 350 : H = V21R.Y) 

300 GOTO 320 

310 FOR W = 1 TO 14 : NEXT 

320 IF X > 200 THEN 210 ELSE 240 

330 IF V1{A,X) ■ THEN 340 ELSE OUT EN.TN : 

OUT V1,V1[A,X) : RETURN 
340 FOR W = 1 TO 2 : NEXT : RETURN 



Once the connections are made, run the 
following few lines, an envelope test: 



10 


OUT 67,128 


REM 


SET 8255 PORT 


20 


A$=INKEYf 


REM 


SCAN KEYBOARD 


30 


IF A»="" THEN 20 


REM 


LOOP IF NO KEY 


40 


OUT 66,1 


REM 


ENVELOPE ON SHOT 


50 


OUT 66,0 


REM 


ENVELOPE OFF SHOT 


60 


GOTO 20 


REM 


LOOP AS NEEDED 



The envelope should be triggered each time 
you touch a key on the TRS-80. If the envelope 
does not trigger, move the interface connection 
to the negative-going envelope, and try again. If 
the envelope is still not working, increase the 
values for C3 or R5, which are found at pins 14 
and 15 of Z8. This will lengthen the trigger 
cycle, and should handle any synthesizer input. 
Again, try both the positive and negative 
envelopes. 

Now disconnect the envelope trigger, and 
patch the envelope out of the synthesizer. Try 
the following program which creates a series of 
fast-rising whoops if the digital-to-analog 
converter is working properly: 



10 


OUT 67,128 


: REM 


20 


INPUT"TIME DELAY" ;N 


: REM 


30 


FOR X = TO 255 


: REM 


40 


OUT 64,X 


: REM 


50 


FOR Y = 1 TO N 


: REM 


60 


NEXT : NEXT 


: REM 


70 


GOTO 20 


: REM 



SET UP 8255 PORT 
GET INTERNOTE DELAY 
SET TO RUN ALL NOTES 
SEND VOLTS TO SYNTHO 
SET UP TIMING LOOP 
TIME, GET NEXT NOTE 
BACK FOR NEXT DELAY 



Each time you run through the program to the 
INPUT statement, increase the value for the 
time delay; the whoops will slow until you can 
hear a series of discrete pitches. If you have a 
two- voice synthesizer (or to test the second voice 
of the interface), connect the voltage output from 
voice 2, and use OUT 71,128 to set the port and 
OUT 68,X for the data. 

If the pitches fall instead of rise, then your 
synthesizer responds to a higher voltage as a 
lower pitch, and any music routines you write 
will have to take this into account. If this is the 
case, before you run change line 60 to read: 

60 OUT 66,32 : OUT 66,0 : OUT 64,(255-ML(1 ,PH]) 

Finally, run Listing 7-4, a rendition of 
keyboard prelude 23 from Johann Sebastian 
Bach's Well-Tempered Clavier. 



Listing Continued . 



The Custom TRS-80 
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Continued Listing 



360 IF V2(A,Y) = Q THEN 360 ELSE OUT EN.TN : OUT EN.TF : 

OUT V2,V2(C,YJ : RETURN 
360 FOR W = 1 TO 2 : NEXT : RETURN 

370 DATA81 ,4,105,2,102,2,87,4,114,4,102,4,120,2,117,2,132,4,126 
380 DATA4, 90, 4, 96, 6, 33, 2, 96, 4 ,123, 2, 11 7, 5,123, 4, 132,8,1 38, 2,1 11 
390 DATA2, 117, 2, 132, 2, 129, 2, 132 ,2, 138, 4, 144, 2, 135, 2, 138, 4, 138, 4 
400 DATA108,4,123,4,87,4,117,4,93,4,96,2,90,2,B7,2,B4 f 2,B7,12 
410 DATA108, 4, 102, 12, 132, 4, 129, 4, 138, 4,135, 4, 129, 4, 123, 4, 111 ,2 
420 DATA120, 2, 123, 4, 87, 4, 108, 4, 75, 2, 81 ,2, 87, 4, 108, 2, 105, 2, 108 
430 0ATA2, 132, 2, 138, 2, 123 ,2, 126, 4, 111 ,4,96,4,99,4,87,4,90,8,93 
440 DATA8, 102,8, 105,8, 108, 4, 132, 4, 93, 4, 138, 4, 91 ,4,105,2,102,2 
460 DATA87, 4, 114, 4, 102, 4, 120, 2, 117, 2, 132, 4, 126, 4, 90 ,4, 87, 2, 90 ,2 
460 DATA96, 2, 102, 2, 96, 2, 102, 2, 105, 2, 87, 2, 93, 2, 129, 2, 132, 2, 126, 2 
470 DATA123,2,126,2,120,2,117,2,111 ,2,106,2,102,2,111 ,2,108,2 
480 DATA111,2,120,2,117,2,111 ,4,138,2,117,2,123,4,121 ,2,105,2 
490 0ATA132,2,126,2,120,2,117,2,111 ,4,132,2,129,2,132,4,102,4 
500 DATA81 ,4,87,2,90,2,96,2,99,2,96,2,117,2,111,2,108,2,111 ,4 
510 DATA114, 4, 111, 16, 0,0, 0,36, 81 ,4, 105, 2, 102, 2, 87, 4, 114, 4, 102 
520 DATA4, 120, 2, 117, 2, 132, 4, 126, 4, 90 ,4, 96 ,6, 93, 2, 96, 4, 123, 2,1 17 
530 DATA2, 123, 4, 132, 8, 138, 2, 111, 2, 117, 2, 132, 2, 129, 2, 132, 2, 138, 4 
540 DATA144, 2, 135, 2, 138, 4, 138, 4, 108, 4, 123, 4, 87, 4, 117, 4, 93, 4, 96 
550 0ATA2, 90, 2, 87, 2, 84, 2, 87, 12, 108, 4, 102, 12, 132, 4, 129, 4, 138, 4 
560 DATA135,4,129,4,123,4,111 ,2,120,2,123,4,87,4,105,4,75,2,91 
570 0ATA2, 87, 4, 108, 2, 105, 2, 108, 2, 132, 2, 128, 2, 123 ,2, 126, 4, 111 ,4 
580 DATA86, 4, 99, 4, 87, 4, 90, 8, 93, 8, 102, 8, 105, 8, 108, 4, 132, 4, 93 ,4 
580 DATA138, 4, 81 ,4, 105, 2, 102, 2, 87, 4, 114, 4, 102, 4, 120, 2, 117, 2, 132 
600 0ATA4, 126, 4, 90, 4, 87, 2, 90, 2, 96, 2, 102, 2, 96, 2, 102, 2, 105, 2,87, 2 
610 DATA93, 2, 129, 2,1 32,2,1 26,2,1 23, 2, 126, 2,1 20,2,1 17, 2,1 11 ,2 
820 OATA105,2,102,2,111 ,2,108,2,111 ,2,120,2,117,2,111 ,4,138,2 
630 DATA117, 2, 123 ,4, 141 ,2,105,2,132,2,126,2,120,2,117,2,111,4 
640 0ATA132,2,128,2,132,16,0,0 : REM * END OF TWO VOICES 
650 REM * THE TUNING SECTION PRODUCES OCTAVE PITCHES 
660 OUT 67,128 : REM » SET UP THE 8255 PIA FOR ACTION 
670 OUT 64,3 : OUT 65,3 : FOR N = 1 TO 1000 : NEXT 
680 OUT 64,38 : 0UT65.39 : FOR N = 1 TO 1000 : NEXT 
680 OUT 64,75 : OUT 65,75 : FOR N = 1 TO 1000 : NEXT 
700 OUT 64,111 : 0UT65,111 : FOR N = 1 TO 1000 : NEXT 
710 OUT 64,147 : OUT 65,147 : FOR N = 1 TO 1000 : NEXT 
720 Al ■ INKEYt : IF A» = "" THEN 670 ELSE RETURN 



10 CLS ! PflINTCHR«(23) »- GENERALIZED MUSIC PROGRAM -" 
80 PRINT I PRINT ! PRINT "DENNIS BATHORY KITSZ, MAY 1979" 
30 FOR X ■= 1 TO 1000 : NEXT : CLEAR : CLS 

40 PRINT'THERE ARE 639 NOTES IN BACH PRELUDE NO. 93" : - 639 
50 GOTO 400 : REM • MOVE TO TUNING ROUTINE BEFORE PLAYING PIECE 
60 DIM ML(2,Q*50] I REM • EXTRA BYTES SET ASIDE FOR LONGER WORK 
70 PRINT i PRINT"NOW READING "; 0; "NOTES FROM NOTE/RHYTHM DATA." 
80 FOR PH = 1 TO : REM • PH SPECIFIES PITCH 6 DURATION ARRAY 
80 FOR NT ' 1 TO 2 : REM • NT SPECIFIES THE TWO ARRAY ELEMENTS 
100 READ ML(NT.PH) : REM • EACH PITCH AND RHYTHM FILLS ARRAY 
110 NEXT NT.PH : REM • READ ENTIRE ARRAY OF 639 NOTES 6 RHYTHMS 
120 INPUT "PRESS ENTER TO START PIECE";Z : REM • WAIT FOR START 
130 FOR PH = 1 TO : REM • READ ARRAY LOOP TO PLAY BACK MUSIC 
140 OUT 66,32 : OUT 66,0 : REM • ENVELOPE TRIGGER ON THEN OFF 
180 OUT 64,ML11,PHI : REM • THEN SEND PITCH TO D/A CONVERTER 
180 FOR X « 1 TO ML(2,PHl : NEXT : REM • ARRAY DURATION DELAY 
170 NEXT PH : REM • AND CONTINUE UNTIL ALL NOTES ARE PLAYED OUT 
180 INPUT "PRE6S ENTER TO PLAY AGAIN"jZ : REM • OPTIONAL REPEAT 
190 GOTO 120 : REM • ANOTHER PIECE MAY BE ADDED AND RUN HERE 
200 DATA69 ,3 1 ,90 ,31 ,117 ,31 ,90 ,31 ,66,31 ,90 ,31 ,111 ,31 ,90 ,31 ,69, 
31, 90, 31, 117, 31, 90 ,31, 54, 31, 102, 31, 126, 31, 102, 31, 60, 31, 
81 ,31, 105, 31, 81, 31, 54, 31, 81, 31, 102, 31, 61 ,31, 60, 31, 61, 31, 
105, 31 ,81 ,31, 46, 31, 90, 31, 117, 31, 90, 31 
210 DATA48.31 ,69, 31, 96, 31, 69, 31, 45, 31, 69, 31, 90, 31, 69, 31, 48, 31, 
69, 31, 96, 31, 68, 31 ,33, 31, 81, 31, 105, 31, 81 ,31 ,39, 31, 81 ,31, 84, 
31, 81 ,31, 33, 31, 81, 31, 96, 31, 81, 31, 30, 31, 75, 31, 90, 31, 75, 31, 
18,31 ,86,31 ,84,31 ,66,31 
220 DATA69, 31, 81 ,31, 80, 31, 81, 31, 54, 31, 88, 31, 81, 31, 69, 31, 45, 31, 
64,31 ,89,31 ,54,31 ,33,31 ,45,31 ,54,31 ,45,31 ,24,31 ,45,31 ,51 , 
31, 67, 31, 60, 31, 66, 31, 69, 31, 75, 31, 69, 31, 60, 31 ,66, 31, 69, 31, 
75,31 ,81 ,31 ,87,31 ,90,31 
23 0ATA76.31 , 67, 31, 96, 31, 87, 31, 60, 31, 75, 31, B7, 31, 75, 31, 51 ,31, 
60, 31, 75, 31, 80, 31, 39, 31, 51 ,31, 60, 31, 51 ,31, 30, 31, 51, 31, 54, 
31, 60, 31, 66, 31, 72, 31, 75, 31, 61 ,31, 75, 31, 66, 31 ,72, 31, 75, 31, 
81 ,31 ,67,31 ,90,31 ,96,31 
240 DATAB1 ,31, 90, 31, 102, 31, 90, 31, 66, 31, 61, 31, 90 ,31, 81, 31, 54, 31, 
66, 31, 81 ,31, 68, 31, 45, 31, 54, 31 ,66, 31, 54, 31 ,33, 31, 54, 31, 81, 
31, 64 ,31, 24, 31, 54, 31, 69, 31, 54, 31, 30, 31, 54, 31, 75, 31, 54, 31, 
18,31 ,54,31 ,84,31 ,64,31 
250 DATA33.31 ,64, 31, 81 ,31, 54, 31, 24, 31, 54, 31, 69, 31, 54, 31, 30, 31, 
54, 31, 75, 31, 54, 31, 1B, 31, 54, 31, 64. 31,54, 31, 33, 31, 54, 31, B1, 
31, 54, 31, 36, 31 ,80, 31, 90, 31, 60, 31, 39, 31, 6D, 31, 87, 31, 60, 31, 
42,31 ,66,31 ,86,31 ,66,31 

26 DATA4S,31 ,66, 31, 80, 31, 66, 31, 9, 31, 69, 31 ,102, 31, 69, 31, 15, 31, 

88, 31, 98, 31, 69, 31, 61 ,31, 75, 31, 105, 31, 75, 31, 54, 31, 75, 31, 
102,31 ,75,31 ,18,31 ,81 ,31 ,111 ,31 ,81 ,31 ,24,31 ,81 ,31 ,105,31 , 
61 ,31 ,60, 31, 87, 31, 117, 31, 87, 31 

27 OATABB, 31, 75, 31, B1, 31, 87, 31, 90, 31, 96, 31, 102, 31, 105, 31, 111, 

31,106,31,102,31 ,96,31 ,90,31 ,84,31 ,81 ,31 ,75,31 ,B1 ,31 ,69, 
31 ,66, 31, 60, 31, 54, 31, 46, 31 ,45, 31, 39, 31 ,33, 31, 39, 31, 45, 31, 
38,31 ,33 , 31 ,30,31 ,24,31 ,16,31 

280 DA TA1 S, 31 ,75, 31, 105, 31, 75, 31, IB, 31, 75, 31, 102, 31, 75, 31, 9, 31, 
68, 31, 102, 31 ,68, 31, 15, 31, 69, 31, 96, 31, 69, 31, 16, 31, 66, 31, 96, 
31, 86, 31, 30, 31, 66, 31, 90, 31, 66, 31, 33, 31, 60, 31, 90, 31, 60, 31, 
39,31,80,31 ,67,31 ,60,31 

290 DATA18.31 ,75, 31, 90, 31, 75, 31, 66, 31, 90, 31, 75, 31, 66, 31, 54, 31, 
66, 31, 75, 31, 66, 31, 54, 31, 75, 31 ,66, 31, 54, 31 ,39, 31, 54, 31, 51, 
31, 45, 31, 39, 31 ,33, 31, 30, 31, 24, 31, 18, 31, 30, 31, 39, 31, 54, 35, 
66,3 8,75,42,84,45,93,48 

3 00 0ATA8, 250, 46, 15, 54, 15, 6 9, 15,81 ,15,99,15,105.15,117,15.126, 



Continued Listing 

200, 45, 15, 54, 16, 69, 15, B1, 15, 98, 15, 105, 15, 117, 15, 126, 50, 38, 
15, 45, 15, 80, 15, 96, 15, 106,15, 117, 15, 126, 131, 132, 31, 135, 31, 
132,31 ,126,31 ,120,31 ,117,31 ,120,31 
310 0ATA126,31,123,31 ,117, 31, 111, 31, 108, 31, 111, 31, 117, 31, 111, 
31, 108, 31, 102, 31, 96, 31, 102, 31, 106, 31, 102, 31, 98, 31, 80, 31, 
84,31 ,81 ,31 ,75,31 ,69,31 ,63,31 ,60,31 ,54,31 ,48,31 ,46,31 ,39, 
31 ,36,31 ,3 0,34,24,37,18,40,12,44,9,48,3,250 
3 20 DATA39, 15,48, 15, 8 0,1 5,7 5,1 5,96, 15,1 11 ,15,120,200,39,15,48, 
15, 60, 15, 75, 15, 96, 15, 105, 15, 111, 15, 120, 50, 54, 15, 66, 15, 75, 
15,90,15,102,15,111 ,15,120,131 ,54,31 ,38,31 ,45,31 ,48,31 ,54, 
31 ,60,31 ,66,31 ,69,31 
330 0ATA8B,31 , 60, 31, 54, 31 , 60, 31 , 68, 31 , 89, 31, 75, 31 ,81, 31, 75, 31, 
89, 31, 66, 31, 69, 31, 75, 31, 81, 31, 84, 31, 80, 31, 84, 31, 81 ,31, 75, 
31, 81 ,31, 84, 31, 80, 31, 88, 31, 102, 31, 105, 31, 111, 31, 117, 31, 
120,34,126,3 7,132,40,138,44,126,46 
340 DATA141 ,250,33,15,45,15,54,15,68,15,90,15,102,15,105,15, 
117,200,33,15,45,15,54,16,68,15,90,15,102,15,106,15,117, 
50,46,15,60,15,89,15,84,15,86,15,106,15,117 ,250,51 ,15,60, 
15,69,15,96,15,105,15,114,200,51 ,15,80,15,75,15,98,15,105 
350 DATA1 5,1 11 ,50,54,15,66,15,75,15,84,15,90,15,102,15,111 ,250, 
102,15,111 ,31 ,102,31 ,80,31 ,B4, 31 ,80,31 ,102,31 ,111 ,31 ,102, 
31 ,111 ,31 ,102,31 ,90,31 ,84,31 ,90,31 ,102,31 ,111 ,31 ,129,31 , 
126,31 ,120,31 ,114,31 ,111 ,31 ,105,31 ,102,31 ,96,31 
360 DATA102.31 ,80, 31, 102, 31, 111, 31, 120, 31, 129, 31, 138, 31, 147, 31, 
141, 93, 111, 31 ,114, 31, 102, 31, 105, 31, 87, 31, 16,15, 39, 15,46, 
15, 54, 15, 75, 16, 90, 15, 105, 15, 111,1 25, B1, 125, 18, 15, 39,16,4a, 
15, 54, 15, 84, 15, 80, 15, 102, 115, 111, 031, 54, 125, 60, 125 
370 DATA33 ,15,45,15,54,15,63,15,81 ,15,80,15,105,250,61 ,31 ,90, 
31, B1 ,31, 68, 31, B6, 31, 68, 31, 81, 31, 90, 31, 81 ,31, 80, 31, 81, 31, 
69, 31, 6B, 31, 68, 31, 81 ,31, SO, 31, 108, 31, SB, 31, 90, 31, 81 ,31, 72, 
31 ,66,31 ,54,31 ,81 ,31 
380 DAT A6 0, 15, 84, 15, -6 1,15, 64, 15, B1, 15, 84, 125, 81, 31, 75, 31, 61, 31, 
84, 31, 61, 31, 75, 31 ,69, 31 ,86, 31 ,68, 31, 75, 31, 68, 31, 66, 31, 60, 
31, 54, 31, 60, 31 , 66, 31, 60, 31, 54, 31, 48, 31, 45, 31, 4B, 31, 54, 31, 
48, 31, 45, 31, 38, 31, 33, 31 ,30, 31 
3 BO 0ATA33.31 , 45 ,31 , 54,31 , 45 ,31 ,45 ,31 ,54 ,31 ,6B ,31 , 54,31 ,54,31 , 
69,31 ,81 ,31 ,69,31 ,69,31 ,81 ,31 ,80,31 ,81 ,31 ,81 ,31 ,90 ,31 ,105, 
31 ,90,31 ,90,31 ,105,31 ,117 ,33,105,35,1.06,37,117,39.126,42, 
117,45,141 ,150 
400 REM •••••••• TUNING SECTION FOLLOWS •••••••• 

410 PRINT'THIS 16 THE TUNING SECTION — OUTPUT IS 3, 39, 75." 
420 PRINT"HOLD SPACE BAR TO BEGIN READING BACH PRELUDE DATA." 
430 OUT 64,3 ! FOR X ■= 1 TO 500 : NEXT : REM • OUTPUT LOW C 
440 OUT 64,30 : FOR X = 1 TO 500 ! NEXT : REM • NEXT OCTAVE 
450 OUT 64,75 : FOR X - 1 TO 500 : NEXT : REM • NEXT OCTAVE 
460 OUT 64,111 I FOR X ■= 1 TO 500 : NEXT : REM • NEXT OCTAVE 
470 OUT 64,147 : FOR X = 1 TO 500 : NEXT : REM • TOP OCTAVE 
480 Al - INKEYI : IF A » - "" THEN 460 I REM • CHECK KEYBOARD 
490 OUT 68,255 : REM • HOPE THAT VERY TOP NOTE IB INAUDIBLE 
500 GOTO 60 : REM • NOW RETURN TO MAIN MUSIC REAOING ROUTINE 



Listing 7-4. Johann Sebastion Bach. 
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P/N 



1 
2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 



SIGNAL 
NAME 



RAS* 
SYSRES* 

CAS* 

A10 

A12 

A13 

A16 

GND 

All 

A14 

A8 

OUT* 

WR* 

INTAK* 

RD* 

MUX 

A9 

D4 

IN* 

D7 

INT* 

Dl 

TEST* 



24 


D6 


26 


A* 


26 


D3 


27 


Al 


28 


D6 


29 


GND 


30 


D0 


31 


A4 


32 


D2 


33 


WAIT* 


34 


A3 


36 


A6 


36 


A7 


37 


GND 


38 


A6 


39 


GND 


40 


A2 



DESCRIPTION 



Row Address Strobe Output for 16-Pin Dynamic Rami 
System Reset Output, Low During Power Up Initialize or 

Reset Depressed 
Column Address Strobe Output for 16-Pin Dynamic Rami 
Address Output 
Address Output 
Address Output 
Addreu Output 
Signal Ground 
Address Output 
Address Output 
Address Output 
Peripheral Write Strobe Output 
Memory Write Strobe Output 
Interrupt Acknowledge Output 
Memory Read Strobe Output 

Multiplexor Control Output for 16-Pin Dynamic Rams 
Address Output 
Bidirectional Data Bui 
Peripheral Read Strobe Output 
Bidirectional Data Bus 
Interrupt Input (Maskable) 
Bidirectional Data Bui 
A Logic "V on TEST* Input Tri-Statei A8-A15, D0-D7, 

WR*, RD*, IN*. OUT*, RAS*. CAS*. MUX* 
Bidirectional Data Bus 
Address Output 
Bidirectional Data Bus 
Addreu Output 
Bidirectional Data Bus 
Signal Ground 
Bidirectional Data Bus 
Address Bus 
Bidirectional Data Bus 

Processor Wait Input, to Allow for Slow Memory 
Address Output 
Address Output 
Address Output 
Signal Ground 
Address Output 
Signal Ground 
Address Output 



NOTE: *meani Negative (Logical "#/') True Input or Output 



23 25 27 29 31 33 35 37 39 



10 12 14 16 18 20 



-n — □ — □ — n — Q — cr 
22 24 26 28 30 32 



-n — n — cr- 
36 38 40 



Mates with AMP P/N 88103-1 Card 
Edge Connector or Equivalent 



Figure 8-1. TRS-80 edge card connector. 



Adding to the System 

In this Chapter we will explore several 
hardware projects to expand the TRS-80's 
capabilities : 

A parallel printer interface for keyboard 
units without an expansion interface. 

An expansion of system RAM and ROM in a 
'reserved' block in the memory map. 

Bank selection of RAM and ROM in that 
'reserved' blank area, and a memory 
expansion that includes bank selected RAM. 

A programmable input/output port device 
and a companion interrupt I/O board. 

Battery backup and real time clock. 

Parallel Printer Interface 

Perhaps the simplest addition to the keyboard 
unit is a printer interface. Radio Shack sells a 
complete cable for this purpose, but building one 
is both less expensive and more enlightening. 

When an LLIST or LPRINT command is 
entered, the computer enters a subroutine which 
plucks each character to be printed, (jhecks its 
value, and converts it if necessary. Line feeds, for 
example, are converted to carriage returns, and 
form feeds are converted to the proper number of 
line feeds according to the value in the printer's 
device control block. 

The final value is written to an address, 
almost exactly as if it were being stored in 
memory. The hardware decodes that memory 
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address and sends the character along parallel 
data lines to the printer. The printer then sends 
a 'busy' signal to the memory address. The 
LPRINT or LLIST routines read this busy 
signal, wasting time until the printer is ready. 
When the busy signal turns off, the next 
character is plucked, converted and sent to the 
printer. The process continues until all 
characters are printed. 

There are disadvantages to this system; 
among them the fact that the printing process 
'hangs up' the computer for the duration. This 



can easily be avoided in an interrupt-driven 
system (see Supplement to Chapter 5), and even 
modified in a less successful way as a 
background routine to the keyboard scan. But 
the overall process is simple, requiring neither 
sophisticated hardware nor complex software. 

Figure 8-1 presents the complete circuit for a 
printer interface board. It consists of three 
sections : 

1. An address decoder for 37E8, the printer 

location. 
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Figure 8-2. Parallel printer interface. 
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2. An 8-bit output buffer for sending 
characters to the printer. 

3. An input buffer for checking the status of 
the printer (busy or out of paper). 

The address decoder is formed by Z 1 and 
Z 2 evaluating the address lines in conjunction 
with RD (read) or WR (write) signals from the 
computer. If WR is sent, buffer Z 6 is 
activated, sending a character to the printer. If 
RD is sent, buffer Z 6 is activated, sending the 
status of the printer to the CPU. 

Power-up the TRS-80, and go through the 
input sequence. If this process does not act 
normally, turn the computer off immediately 
and recheck the wiring. If all is normal, it's time 
for a printer test. Turn the printer on (don't be 
surprised by a return to MEMORY SIZE? if your 
printer is an older, electrically noisy one). The 
simplest way to test the printer interface is to 
load any program and LLIST it. The printer 
should spring to life, printing a complete list. If 
there are problems, they will probably be among 
the following : 

No characters printed at all; computer 
immediately (or after a short pause) returns to 
ready. 

Characters are being sent to the memory 
address, but not being received by the printer. 
Therefore, no 'busy' is being received, and the 
computer dumps all its characters as fast as it 
can. 

Solution : check wiring of the port address, 
wiring to the output buffer select line, and see 
that the board has both power and ground 
wires connected. 

No characters printed at all; computer 
immediately locks up : 

Characters are being sent to the memory 
address, but if none are printed, they are not 
being received by the printer. The computer is 
seeing a constant 'busy' signal, and thus is 
waiting in a loop. 

Solution : check wiring of the port address, 
wiring to the input buffer from the printer, 
and see that the printer is enabled (if it has an 
enable function). 

Intermittent but regular characters (every 
third or fifth or fiftieth character, for example) 
are being printed. 

Characters are being sent through to the 



printer, but no handshake ('busy') is being 
received by the computer. 

Solution : check wiring of the input buffer 
select line, and the wiring from the printer's 
busy signal. Some printers may not have a 
busy signal; see box for suggestions.. 

A single character is printed, then printing 
stops and the computer locks up. 

A constant busy is being received by the 
computer, and it is waiting in a loop for the busy 
signal to terminate. 

Solution : check for ground shorts in the 
printer's busy line, or shorts to ground at the 
input buffer. 

Incorrect characters are printed, and none or 
any of the above symptoms are present. 

The data lines are incorrectly wired to the 
printer or to the board's output buffer. The 
printer may be wired for complement ASCII. 

Solution : check the wiring of the data lines 
for reversed wires, either at the computer or 
printer end. If all is well, enter the following 
short program : 

10 FOR X = 65 TO 91 
20 Y = NOT X AND 255 
30 POKE 14312, Y 
40 FOR N = 1 TO 100 
50 NEXT : NEXT 

Listing 8-1. Printer interface test routine. 

This program produces the complement of the 
letters from A to Z. If the correct letters are 
printed this time, replace Z 5 with an inverting 
buffer, type 81LS96. 

Talking with the World - 
The Computer as Boss 

The TRS-80 has remarkable skills for 
controlling the world around it. Four BASIC 
commands (POKE, PEEK, INP, and OUT) and 
their machine language equivalents (LD register, 
LD memory, IN register, OUT port) are the 
software conversational tools by which the 
computer makes its wishes known. 

Only one dilemma remains: very little 
hardware was provided with the TRS-80 to use 
these powerful features. Just a single port (255) 
was hard-wired in place, and it is limited to 
controlling cassette functions and video display 
size. Memory mapped input/output was left 
exclusively to the expansion interface. And even 
then then, only for a printer, dual cassette, 
RS-232 and disks. In each case, no uncommitted 
user ports or memory addresses were provided. 
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Fortunately, creating such input/output (I/O) 
is not difficult. There are two very effective ways 
to accomplish it: 

1. Using inexpensive, separate logic devices 
that can be dedicated to their interfacing 
tasks. The TRS-80 Technical Reference 
Handbook describes such simple hardware in 
its 'coffee pot' scenario. 

2. Using more costly programmable 
interface devices (such as the INS8255 
peripheral interface adaptor) for handling 
more flexible, general purpose I/O. 

In either case, the input/output device must be 
identifiable by the computer, which means it 
must somehow be located. It is assigned a port 
number or a memory address. But what does this 
number mean, and how does it work? I have often 
used the analogy of the key in the lock, because it 
so well describes the way the electronics can open 
the doors to the world outside its case. 

Figure 8-3 shows a simple-minded lock and 
key. It is simple minded because there are no fine 
graduations in the height of the tumblers - the 
'pins' either rise to a single height, or are not 
present at all. In the computer, these pins are 
really voltages, represented by numbers. 



In other words, the higher voltage can be called 
a 'one', and the lower voltage can be considered a 
'zero'. In this way, the key number code shown in 
Figure 8-3 might look like this : 



ON ON OFF ON ON OFF OFF OFF 
110 110 



The sample key's code (binary 1101 1000) 
works out to the hexadecimal value D8, or the 
decimal equivalent 216 (refer to Chapter 2 for 
details on binary, decimal, and hexadecimal 
numbers). The 'key' is the value that the 
computer will output; the 'tumblers' are the 
hardware which will unlock when this key is 
inserted. 

Below is the schematic of a general purpose 
'tumbler' which can be adjusted to open to any 
electronic key. As noted in Chapter 2, the 
triangles are buffers which protect the TRS-80 
electronic hardware from overexertion. Once 
again, the triangle with the 'not' circle at its point 
is an inverting buffer, which reverses the value of 
any signal placed at its input. 





Figure 8-3. Lock-and-key illustration. 



Figure 8-4. Unconnected buffer diagram. 
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This is very elementary - it will be improved on 
later - but it is the central scheme of digital 
operation. Real tumblers must all be lifted to a 
point so they are in line with the edge of the lock's 
cylinder. Electronically, the same thing must 
take place. To turn the electronic cylinder, all 
the binary input values must be lifted (or 
depressed) to the same value before the 
electronic lock will click open. 

*******•***♦****•*••*•••*•******»•»•*»»*•»♦*♦*»***«**•*•**. 



Using Exclusive-OR for decoding 



Resistor 1K ohms to Ground; Switch to Plus Volte 



Switch Position 



OFF [gete eeeB 0) 
ON (gete eeee 1] 
OFF (gate eeeB 0) 
ON [gate sees 1) 



Input Value 



Output Value 



Resistor 1K ohms to Plus Volte; Switch to Ground 



Switch Position 



OFF [gate sees 1 ] 

ON [gate Bees 0) 

OFF [gete eeee 1 ] 

ON [gete sees 0J 



Input Value Output Velue 



A*********************************************************** 



Table 8-1. Using exclusive- OR for decoding. 




Figure 8-6. Improved port decoding for port addresses. 



Figure 8-5 is the schematic for an elementary 
interface circuit. Zl and Z2 form the tumblers, 
and Z3 is the cylinder. 

There is another way to produce the same 
effect as Zl and Z2, and no rewiring or jumpering 
is necessary. To do it, you can use one or two 
74LS86 exclusive OR gates. Exclusive OR is a 
remarkable electronic function which states : 

// two input signals are alike, the evaluated 
result will be set to zero. If two input signals 
are different, the evaluated output will be set 
to one. 

Here's how that might work electronically. 
One input of an exclusive OR gate is attached to 
a switch and a resistor. The resistor is attached 
to ground, with the switch connected to the 
positive voltage line. When the switch is off, the 
input looks like a zero. When the switch is on, the 
lower resistance of the switch makes the input of 
the gate see a one. 

Therefore, with the switch off, a signal coming 
into the second input of the gate would cause a 
one output when it is a one. With the switch on, 
a signal coming into the second input of the gate 
would cause a zero output when it is a one. Refer 
to Table 8-1. 

By using eight exclusive OR gates (two type 
74LS86 circuits) and an 8 position DIP (dual 
inline package) switch, any one of the 256 
possible ports can be selected. The circuit below 
(Figure 8- 6 ) shows how Zl and Z2 in Figure 
8- 5 can be replaced with a switch and the 
74LS86's to select the port. Thus, jumpering and 
soldering from the original Zl and Z2 can be 
avoided. 

Now, before putting these ports to use, it's 
time to turn to the other type of input/output 
device - the programmable interface adaptor. 
The previous I/O device costs perhaps $5 to 
create. The central integrated circuit to the 
programmable I/O port itself costs about $8, but 
it offers some extra features and easier wiring. 

The INS8255 is a single integrated circuit 
capable of providing three complete 
input/output ports. Each port can act as an input 
or output, and that condition can be changed via 
programming. This is how it is done: using a 
decoder similar to that designed above, a 'chip 
select' is formed. 

When the 8255 receives the chip select, it 
examines its two address line connections. Two 
address lines can be configured four ways (00, 01, 
10, 11), and so can select one of the three I/O 
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Figure 8-5. Elementary interface. 
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Figure 8-7. 8255 configuration (control). 
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Figure 8-8. 8255 configuration (data). 
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ports, or - and this is the remarkable part - the Three Real-Time Clock/Calendars 

8255's internal control register. The 8255 is a m „. ., ,. , . . . , . A . 

. , . , Telling the time and date is a legitimate 

smart chip! ", , , . , 

concern of computer users, not only for keeping 

When the control register has been selected, documents in order, but also for observing and 

the 8255 can be programmed - its ports may be controlling experiments. Until recently, the 

defined as input or output, and other on i y type of real-time clock available was the 

combinations of actions can be selected. The one built into the expansion interface, which 

various possibilities are shown in Figure 8-7 disk and Level III users could access with the 

and 8-8. TIME$ command. 

The principle of that clock is simple: forty 
times each second, a pulse is sent from the 
expansion box to the TRS-80 keyboard unit, 
where it is applied to the interrupt (INT) line. 
The computer responds by temporarily setting 
aside its other processing activities in order to 
update the seconds, minutes, and hours. When 
the user asks for the TIME$, the computer 
checks the area of memory in which this updated 
information is stored, and sends it to the current 
display device. 

The clocks presented in this section all use the 
TIME$ function, but avoid certain problems 
associated with the expansion box TIMES 
function. First and foremost, it eliminates the 
need for the expansion box itself, and the special 
software to use the 25-millisecond interrupt. 

Without disk, this special software must be 
loaded for every session, reloaded if an 
inadvertent reset should occur, updated should 
the computer be turned off, and disabled at every 
CLOAD and CSAVE. Though convenient in a 
disk system, this type of approach is more of an 
annoyance in a Level II system. 

There are, however, two distinct advantages 
to an interrupt- based system for timekeeping: 
the hardware is simple and cheap to create, and 
in certain ways the clock pulses generated by the 
power line are more accurate than crystal- 
controlled clocks. The power line, because it is 
linked into a large network of generating 
systems, must maintain a virtually absolute 
synchronization over the long term. Short 
duration lags and leads in the 60-cycle pulses 
may appear, but the percentage of error over 
weeks, months, and years is virtually nil. 

Time updating from a simple pulse train can 
be complicated, too, because seconds, minutes 
and hours, days, weeks, months and years aren't 
very 'decimal' in their counting. 59 seconds plus 
one second is one hour and zero seconds. 23 
hours and one hour is one day and zero hours. 
You get the idea. So the software to update a 
pulse-based calendar needs special math, 
charts, and tables to keep the time and date in 
its electronic mind. 
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Figure 8-9. Interrupt-driven RTC (one second). 
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00530 
00540 
00550 
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0580 
00590 
00600 
00610 
00620 
00630 
00640 
00650 
00660 
00670 
00680 
00690 
00700 
00710 
00720 
00730 
00740 
0D750 
00760 
00770 
00780 
00790 
00B00 
00810 
00820 
00830 
00840 
00B50 
00860 
00870 



it iiiimm it nmmm mm,,, ,,,,,,,,,,,,,,,,,,,,, 

THIS ROUTINE WILL USE THE ONE-SECOND INTEHRUPT CREATED 
BY A HARDWARE ADDITION TO DO TIMEKEEPING. THIS IS 
TRANSPARENT TO BASIC. NOTE THAT THIS IS NOT INCLUDEO 
IN THE SLASH (/) FUNCTIONS CALLED BY THE CUSTOM 
INTERPRETER, AND THUS RETURNS ON ITS OWN TO BASIC ROM. 

iimmmimtmmmmmummmmmmm, 



ORG 



7EC0H 



CHANGE TO RELOCATE 



01 




LD 


HL.START1 


LD 


(4177H) ,HL 


LO 


HL.START2 


LD 


I4174H] ,HL 


LD 


A.0C3H 


LD 


(4012H) ,A 


LD 


HL, SERVE 


LD 


(4013H) ,HL 


IH 


1 


EI 




JP 


06CCH 



it 1 1 ii ii 1 1 iii i iii mm iii i mm, in,, ,,,,,,,,,,, urn 

PATCH INTO 00S TIMEI ERROR LOCATION AND CHANGE IT 

iinimmiimmmtmitmtmimtiiiimiimm 

DISABLE ACTIVE INTRPTS. 
ENTRY OF TIME* PROGRAM 
REPLACE ?L3 ERROR MSG. 
START OF "CMD" PROGRAM 
REPLACE ?L3 ERROR MSG. 
GET "JUMP" COMMAND 
INSERT INT. PATCH POINT 
INTERRUPT SERV. ROUTINE 
INT. PATCH FROM 0038H 
SET INTERRUPT MODE #1 
ENABLE INTERRUPT LINE 
RETURN TO BASIC "READY" 

ii t m mmmimmmmmtmm, ,,,,,, ,,,,,,,,,, 

PATCH TO INTERCEPT ?L3 ERROR AND CHECK LINE'S SYNTAX 

it 1 1111111111111 imimmimi, mm, mmimimi 



HOUSEKEEP SPACE, ETC. 
SAVE BASIC LINE POINTER 
LENGTH OF TIME* ITSELF 
ROM STRING SPACE SETUP 
LOCATION TO FIND TIMEI 
POINT DE TO HOURS POS'N 
CONVERT, PLACE IN TIME$ 
PUT COLON INTO TIMEI 
BUMP TIME« POINTER 
SET DE TO MINS. POS'N 
CONVERT, PLACE IN TIMEI 
PUT COLON INTO TIMEI 
BUMP TIMEI POINTER 
SET DE TO SECS. POS'N 
CONVERT, PLACE IN TIMEI 
PUT SPACE INTO TIMEI 
BUMP TIMEI POINTER 
POINT DE TO MON. POS'N 
CONVERT, PLACE IN TIMEI 
PUT SLASH INTO TIMEI 
BUMP TIMEI POINTER 
SET DE TO DAYS POS'N 
CONVERT, PLACE IN TIMEI 
PUT SLASH INTO TIMEI 
BUMP TIMEI POINTER 
POINT DE TO YEARS POS'N 
CONVERT, PLACE IN TIMEI 
FINISH DISPLAY IN ROM 



miimimiitmmiitmmmmmimmimmit 

FIND VALUES IN TIME LOCATIONS AND CONVERT TO ASCII 

ti i mint ti it 1 1 tmt mitmiimiiimtmmmtmt 



RST 


1DH 


PUSH 


HL 


LD 


A.11H 


CALL 


2857H 


LD 


HL, [4004H] 


LD 


DE,SEC0ND+2 


CALL 


DISPLY 


LD 


(HL) ,3AH 


INC 


HL 


DEC 


DE 


CALL 


DISPLY 


LO 


1HL) ,3AH 


INC 


HL 


DEC 


DE 


CALL 


DISPLY 


LD 


IHL) ,2DH 


INC 


HL 


LO 


DE.SEC0N0+4 


CALL 


DISPLY 


LD 


(HL) ,2FH 


INC 


HL 


DEC 


DE 


CALL 


DISPLY 


LD 


(HL) ,2FH 


INC 


HL 


LD 


DE.SECOND+5 


CALL 


DISPLY 


JP 


2B84H 



LD 

CALL 

LD 

XOR 

INC 

DEC 

JR 

ADD 

DAA 

JR 

LD 

LD 

CP 

JR 



A, IDE) 
NIBBLE 
8, A 

A 



Z, LEAVE 
A,16H 

LOOP 

B, A 

A,C 

DAH 

C, CLEAN 



GET VALUE INTO ACCUM. 
SEPARATE INTO 4 BITS 
VALUE INTO B FOR TEST 
CLEAR A FOR USE IN LOOP 
DUMMY INCREMENT ... 
DECREMENT TO TEST FOR 
UPPER NIBBLE NOW AT 
A=A+16 ...HEX-DEC CONV. 
DEC. ADJ.: 16 BECOMES 10 
LOOP TILL CONV. DONE 
SAVE VALUE BACK IN B 
GET LOW NIBBLE BACK 
IS IT GREATER THAN 10? 
NO WORK IF LESS THAN 10 



Listing 8-2. Interrupt-driven RTC (one second). 



Figure 8-9 is a one-pulse-per-second clock 
that triggers the keyboard unit's interrupt line. 
Because this clock and the expansion box would 
compete for that line, this circuit cannot be used 
in a complete TRS-80 system. But it is a $5 
project, and an inexpensive clock add-on for 16K 
systems alone. 

It consists of five integrated circuits. One 
regulates the voltage, the second (Z2) takes the 
sine-wave-shaped signals from the 6.3-volt 
power transformer and converts them to a sharp- 
edged digital signal. Z3 and Z4 divide the 60 Hz 
signal into a one-pulse-per-second signal. 
Finally, Z5 provides the 1 Hz interrupt signal. 

When the interrupting signal is accepted by 
the TRS-80, an 'interrupt acknowledge' signal is 
sent back to Z5. There is an important purpose 
to this action; it turns the interrupt signal off. 
Why? When the computer receives the interrupt, 
it sets aside its present software activities to 
'service' the interrupt. Unless the interrupting 
flip-flop is reset, the computer, upon completing 
the interrupt service routine, will think the 
previous interrupt is a new interrupt, and it will 
keep updating the time and date. 

Software to run this clock is presented in 
Listing 8-2. It patches into the TIMES and 
CMD locations, and accepts time and date in the 
following format (use spaces and punctuation 
exactly as shown) : 

CMD"09:15:22 05/18/81" 

The program checks for correct syntax of the 
set-time command line, but doesn't verify actual 
times or dates. So, until the clock is next 
updated, it will display whatever bizarre time 
and date you may have set it to! 

To print the time and date, enter PRINT 
TIME$. You may use TIME$ just as you would 
any other strings, including with PRINT, 
LPRINT, MID$, LEFT$, RIGHTS, 
concatenation, and other string manipulation. A 
complete description of these programs is in the 
supplement to this chapter. 
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7F2D D60A 
7F2F C610 
7F31 80 
7F32 27 
7F33 CD4D7F 
7F36 C630 
7F38 77 
7F39 23 
7F3A 79 
7F3B C830 
7F3D 77 
7F3E 23 
7F3F C9 



7F40 F5 
7F41 E60F 
7F43 4F 
7F44 F1 
7F45 1F 
7F4B 1F 
7F47 1F 
7F4B 1F 
7F49 E60F 
7F4B C9 



40 41 

7F4C 

7F4D 

7F4E 

7F4F 

7F50 

7FS3 

7F54 

7F56 

7FB9 

7F5A 

7F5B 

7F5D 

7FBF 

7FB2 

7F84 

7F66 

7F69 

7F8B 

7F6D 

7F70 

7F71 

7F74 

7F75 

7F7B 

7F77 

7F79 

7F7C 

7F7E 

7F80 

7FB3 

7FB4 

7FB5 

7F86 

7F87 



F3 

F0 

E5 

D6 

3A4S40 

5F 

1600 

214140 

34 

7E 

FE3C 

3824 

C0897F 

FE3C 

381 D 

CD887F 

FE18 

3B16 

C0B97F 

ES 

21837F 

19 

BE 

E1 

380A 

CDBF7F 

FEOD 

3B03 

CD8F7F 

D1 

tl 

F1 

FB 

ED4D 



7F89 AF 

7FBA 77 

7FBB 23 

7FBC 34 

7F8D 7E 

7FBE C9 

7FBF 3E01 

7F91 1BF7 



7F93 00 

7F94 20 

7F95 1D 

7F96 20 

7F87 1F 

7F98 20 

7F89 1F 

7F9A 20 

7F8B 20 

7F9C 1F 

7F9D 20 

7F9E 1F 

7F9F 20 



00880 
008 90 
00900 
00910 
00920 
00930 
09 40 
00950 
008B0 
00870 
00980 

09 90 
01000 
01010 
01020 
01030 
01040 
01050 
01080 
01070 
01080 
01080 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
01170 
01180 
01190 
01200 
01210 
01220 

01 23 
01240 
01250 
012B0 
01270 
01280 
01 290 
01300 
01310 
01320 
01330 
01340 
01350 
01360 
01370 
01380 
01390 
01400 
01410 
01420 
01430 
01440 
01450 
0146 
01470 
014B0 
01490 
01500 
01510 
01520 
01530 
01540 
01550 
01560 
01570 
015B0 
01590 
01600 
01610 
01620 
01630 
01640 
01850 
01660 
01670 
01680 
01630 
01700 
01710 
01720 
01730 
01740 
01750 
01760 
01770 
01780 
01790 
01800 
01910 
01B20 
01830 
018 40 
01850 
01B60 
01B70 
018 80 
01890 
01900 



; REDUCE IT TO THRU 5 

; NOW ADD CARRY BIT 

; CREATE A DECIMAL RESULT 

i DEC. ADJ. THE TOTAL 

i SEPARATE INTO 4 BITS 

; CONVERT NIBBLE TO ASCII 

; PLACE. VALUE INTO TIME* 

; BUMP TIME* PTR. BY ONE 

; SET VALUE SAVED IN C 

; CONVERT NIBBLE TO ASCII 

; PLACE VALUE INTO TIHE* 

; BUMP TIME* PTH. BY ONE 

; BACK TO DO PUNCTUATION 

mttittmttiiiitmnntniumunttnmmttmn 

SUBROUTINE TO CONVERT A BYTE AND SAVE IT AS TWO NIBBLES 

mmnnui i minium miiuutm mummmu 



SUB 


OAH 


ADD 


A.10H 


ADD 


A,B 


DA A 




CALL 


NIBBLE 


ADD 


A.30H 


LD 


[HLJ ,A 


INC 


HL 


LD 


A,C 


ADD 


A.30H 


LD 


(HL) ,A 


INC 


HL 


RET 





PUSH 

AND 

LD 

POP 

RRA 

RRA 

RRA 

RRA 

AND 

RET 



AF 
DFH 
C,A 
AF 



SAVE THE BYTE BRIEFLY 
MASK OUT THE HIGH BITS 
SAVE LOW NIBBLE IN C 
GET THE WHOLE BYTE BACK 
MOVE THE BYTE RIGHT.. . 
. . . TWO PLACES .. . 
. . . THREE PLACES . . . 
UNTIL MSB BECOMES LSB 
MASK OUT THE HIGH BITS 
NIBBLES NOW IN A £. C 



utuunmtunuunnuuuununmnmuuun 

INTERRUPT SERVICE ROUTINE IS ENTERED AT 1 -S CLOCK PULSE 
llUmummumlmUUmUlltn !###»*#########/# 



SECOND 
SERVE 



OUT 



EQU 

DI 

PUSH 

PUSH 

PUSH 

LD 

LD 

LD 

LD 

INC 

LD 

CP 

JR 

CALL 

CP 

JR 

CALL 

CP 

JR 

CALL 

PUSH 

LD 

ADD 

CP 

POP 

JR 

CALL 

CP 

JR 

CALL 

POP 

POP 

POP 

EI 

RETI 



40 41 H 

AF 

HL 

DE 

A,(SEC0ND+4) 

E,A 

0,0 

HL, SECOND 

(HL) 

A, [HL) 

60D 

C.OUT 

TICTOC 

60D 

C.OUT 

TICTOC 

24D 

C.OUT 

TICTOC 

HL 

HL, LOOKUP 

HL,OE 

IHL) 

HL 

C.OUT 

TIKTOK 

13D 

C.OUT 

TIKTOK 

DE 

HL 
Af 



LOCATION TO STORE TIME* 
DON'T BOTHER ME NOW I 
SAVE ACCUM. & FLAGS 
SAVE HL REGISTER PAIR 
SAVE DE REGISTER PAIR 
GET CURRENT MONTH VALUE 
SAVE MONTH VALUE IN E 
LET 0=0. REASON FOLLOWS 
START AT SECONDS POS'N. 
SECONDS = SECONDS + 1 
GET READY TO COMPARE 
IS IT 60 SECONDS? 
DONE IF NOT 60 SECONDS 
ADVANCE TIME SUBROUTINE 
IS IT 60 MINUTES7 
DONE IF NOT 60 MINUTES 
AOVANCE TIME SUBROUTINE 
IS IT 24 HOURS? 
DONE IF NOT 24 HOURS 
AOVANCE TIME SUBROUTINE 
SAVE REGISTER BRIEFLY 
DAYS-IN-MDNTH TABLE 
REMEMBER DE? SEE ABOVE 
IS IT LAST DAY OF MONTH 
GET REGISTER BACK NOW 
DONE IF NOT LAST DAY 
AOVANCE DATE SUBROUTINE 
IS IT 12 MONTHS? 
DONE IF NOT 12 MONTHS 
AOVANCE DATE SUBROUTINE 
RESTORE DE REGISTERS 

RESTORE HL REGISTERS 
RESTORE ACCUM. & FLAGS 
GET CLOCK TICKING AGAIN 
BACK FROM THE INTERRUPT 



it ttmiummtmmuuumuut mmummuu 

ADVANCE TIME/DATE & RETRIEVE NEW VALUE SUBROUTINES 

ui mm urn mummmu mm immumumu 



TICTOC 
FINISH 



XOH 

LD 

INC 

INC 

LD 

RET 

LD 

JB 



A 

[HD ,A 

HL 

(HL) 

A,(HL) 

A,1 
FINISH 



CLEAR ACCUM. TO ZERO 
HRS, MIN, OR SEC - 
MOVE TO NEXT POSITION 
TIME ■ TIME ♦ 1 ICARRY) 
SET UP TO TEST VALUE 
BACK TO COMPLETE TEST 
A = 1 FOR DAY OR MONTH 
OTHER ROUTINE DOES WORK 



II II llll Itlllll II It I Ull III tllllllllUllltlltUIII III! I 

THIS IS THE DAYS-IN-A-MONTH LOOKUP TABLE - NO LEAP YEAR 

iiiumiuiuuuiuminuuuinnnimunimui 



DEFB 
DEFB 
OEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
DEFB 
OEFB 



00 

32D 

290 

32D 

31D 

32D 

31D 

32D 

3 2D 

31D 

32D 

31D 

320 



DUMMY BYTE, BUT THEN.. . 
THIRTY DAYS HATH 

SEPTEMBER, 
APRIL, JUNE, AND 

NOVEMBER; 
ALL THE REST HAVE 

THIRTY-ONE, 

'CEPT FEBRUARY, AND 

THERE'S BEEN ALL 
TOO MUCH TALK 
ABOUT THE MYRIAD 
PRETIDIGITATIONS 
USING THAT MONTH 



it imnutunmuuuuiutuuiuuuiiiunitniu 

"CHD" PATCH CHECKS PARAMETERS, SYNTAX, AND SETS TIME 
iitimitituitntuittniuutitiutiitiututuuiui 



The second and third clocks for the TRS-80 
are similar in concept, but different in 
execution. That difference has only to do with 
manufacturing quality of the specifiedclock- 
calendar chip, the MSM5832 (available from 
Digi-Key Corporation and Hobbyworld 
Electronics — see Appendix). This clock- 
calendar has been designed to interface with 
microcomputers instead of the familiar red LED 
readouts. A 32.768 KHz crystal is required for 
its operation (also sold by the above suppliers). 

It provides time in hours (12 or 24), minutes 
and seconds; month, day, year (leap year as 
well) and day of the week. It has timing signal 
outputs for interrupt use, which will not be used 
in this circuit. A battery backup will keep it in 
time when the TRS-80 is turned off. Two 
complete circuits are presented in Figure 8-10 
and Figure 8-11 

Why two circuits? Because the MSM5832 is a 
relatively slow electronic circuit, and, depending 
on the quality of the production run used for the 
chip you purchase, it may or may not be fast 
enough to interface directly with your TRS-80! 

For a slower chip, you will need to use 
intermediate logic to latch onto the clock 
information in its own good time, and feed it to 
the TRS-80 as the computer's signals speed past. 
For this job, the INS8255 (as recommended by 
OKI, manufacturers of the MSM5832) is used. 
As noted above, the 8255 is a peripheral interface 
adapter, which sets up a private, latched bus 
between itself and the clock chip. Clock 
information is sent via Port A. The clock chip's 
address lines are selected through Port B, and 
other timekeeping features are selected through 
Port C. 

The 8255 will be placed in the TRS-80 
memory map at 37D0 through 37D2, below the 
cassette/ disk latches, and above the Level II 
operating system. Zl and Z2 in Figure 8-10 
decode that address group, and pins 8 and 9 of 
the 8255 (Z3) are used to select the specific 
address among those. 

The last circuit, Figure 8-11. places the 
MSM5832 directly into the TRS-80 memory 
map without use of the 8255 interface chip. 
Because the MSM5832 has four address lines, it 
is decoded differently from the 8255, but 
occupies the same general area (37D0 to 37DF). 

Wiring all these clocks is a simple procedure 
because there are few parts. All can be soldered 
or wire wrapped, though sockets are virtually 
essential for the 8255 and MSM5832 chips. The 
latter is a static-sensitive chip, and should be 
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Figure 8-10. MSM5832 with 8255 port chip $TC 
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= 20 pf 



IC 


TYPE 


+5V 


GND 


Z1 


74LS30 


14 


7 


Z2 


74LS260 


14 


7 


Z3 


74LS04 


14 


7 


Z4 


MSM583S 


1 


13 



Figure 8-11. MSM5832 direct to bus RTC. 
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01910 










7FA0 


114340 


01920 


3TART2 


LD 


DE.SECOND+2 


; POINT DE TO HOURS POS'N 


7FA3 


7E 


01930 




LD 


A,(HL) 


; CHAR AT LINE POINTER 


7FA4 


FE22 


01940 




CP 


22H 


; IS IT A QUOTE MARK? 


7FA6 


204A 


01950 




JR 


N2, OTHERS 


| CHECK FOR CMDT OR CHDR 


7FAB 


CDDB7F 


01960 




CALL 


CONVRT 


; READ/CONV. ASCII HR. 


7FAB 


FE3A 


01970 




CP 


3AH 


■ IS IT A C0L0N7 


7FAD 


C28719 


01980 


3YNERR 


JP 


NZ.1997H 


; BO TO ?SN ERROR ROUTINE 


7FB0 


CDDB7F 


01990 




CALL 


CONVRT 


i READ/CONV. ASCII MIN. 


7FB3 


FE3A 


02000 




CP 


3AH 


IS IT A COLON? 


7FB5 


20F6 


02010 




JR 


NZ.SYNERR 


, SYNTAX ERROR IF NOT : 


7FB7 


C0DB7F 


02020 




CALL 


CONVRT 


; READ/CONV. ASCII SEC. 


7FBA 


FE20 


02030 




CP 


20H 


, IS IT A SPACE? 


7FBC 


20EF 


02040 




JR 


NZ.SYNERR 


SYNTAX ERROR IF NOT 


7FBE 


1 14540 


02050 




LD 


DE .SECOND* 4 


POINT DE TO MONTH POS'N 


7FC1 


C0DB7F 


02060 




CALL 


CONVRT 


READ/CONV. ASCII HON. 


7FC4 


FE2F 


0U070 




CP 


2FH 


; IS IT A SLASH? 


7FC6 


20E5 


02080 




JR 


NZ.SYNERR 


, SYNTAX ERROR IF NOT / 


7FC8 


C00B7F 


02090 




CALL 


CONVRT 


READ/CONV. ASCII DAY 


7FCB 


FE2F 


02100 




CP 


2FH 


IS IT A SLASH? 


7FCD 


20DE 


02110 




JR 


NZ.SYNERR 


SYNTAX ERROR IF NOT / 


7FCF 


114640 


02120 




LD 


DE, SECONDS 


POINT DE TO YEARS POS'N 


7F02 


CD0B7F 


02130 




CALL 


CONVRT 


READ/CONV. ASCII YEAR 


7FD5 


FE22 


02140 




CP 


22H 


IS IT A OUOTE MARK? 


7FD7 


2001 


02150 




JR 


NZ.EXIT 


DONE IF A QUOTE HARK 


7FD9 


23 


02160 




INC 


HL 


BUMP POINTER PAST QUOTE 


7FDA 


C9 


02170 EXIT 


RET 




BACK TO BASIC 






02180 














02190 


tn mil tt it in imiiimi it mi mill tuttui ii utitu 






02200 


CONVERT ASCII 


TO HEX AND POKE 


NTO CLOCK TIMEI LOCATION 






02210 
02220 
223 ( 


niiiniiiiiiniiiiimiiiiiniiiiii mm milt limit 


7FDB 


23 


0NVRT 


INC 


HL 


BUMP LINE PTR. BY ONE 


7FDC 


7E 


02240 




LO 


A,(HL) 


GET CHARACTER IN LINE 


7FDD 


D630 


02250 




SUB 


3 OH 


CONVERT ASCII TO HEX 


7FDF 


3C 


02260 




INC 


A 


MAKE A BE AT LEAST 1 


7FE0 


47 


227 




LD 


B.A 


SAVE THAT VALUE IN B 


7FE1 


3EF6 


02280 




LD 


A.0F6H 


A= 100 HEX MINUS 10 DEC 


7FE3 


C60A 


02280 t 


ULT 


ADO 


A, OAM 


MULTIPLY BY ADDITION 


7FE5 


1DFC 


02300 




DJNZ 


MULT 


I.E. , A » B TIMES 10 


7FE7 


47 


02310 




LD 


B,A 


SAVE THAT VALUE IN B 


7 FES 


23 


23 20 




INC 


HL 


BUMP LINE PTR. BY ONE 


7FE9 


7E 


02330 




LD 


A, [HL) 


BET CHARACTER IN LINE 


7FEA 


0630 


23 40 




SUB 


30H 


CONVERT ASCII TO HEX 


7FEC 


B0 


02350 




ADD 


A,B 


A = IB • 10) + A 


7FED 


1 2 


02360 




LD 


(DE) ,A 


TIME IS SET, PUT IN DE 


7FEE 


i B 


23 70 




DEC 


DE 


BUMP DE TO NEXT PLACE 


7FEF 


23 


02380 




INC 


HL 


BUMP LINE PTR. BY ONE 


7FF0 


7E 


23 90 




LD 


A.IHL) 


GET CHARACTER IN LINE 


7FF1 


C9 


02400 




RET 




RETURN FOR FURTHER TEST 


7FF2 


FE52 


2410 C 


THERS 


CP 


52H 


IS IT CMDR [CLOCK OFF)? 


7FF4 


2003 


02420 




JR 


NZ.NEXT 


NOPE, TRY FOR CMDT 


7FF6 


F3 


02430 




01 




TURN OFF THE CLOCK 


7FF7 


23 


02440 




INC 


HL 


BUMP LINE PTR. BY ONE 


7FFB 


ca 


02450 




RET 




BACK TO BASIC PROGRAM 


7FF9 


FE54 


02460 f 


EXT 


CP 


54H 


IS IT CMDT (CLOCK ON)? 


7FFB 


20B0 


02470 




JR 


NZ.SYNERR 


NOPE, MUST BE ERROR 


7FFD 


FB 


02480 




EI 




TURN ON THE CLOCK 


7FFE 


23 


02490 




INC 


HL 


BUMP LINE PTR. BY ONE 


7FFF 


C9 


02500 
02510 




RET 




BACK TO BASIC PROGRAM 






02520 


iimtt, 


iiiiiiiiiiiiiiiiiihiiii 


7ECD 




0253 




END 


ENTRY 




0000C 


TOTAL 


ERRORS 












handled carefully (see Chapter 4 for details). 
Use wires as short as possible in the area where 
the crystal is located, and triple-check all 
connections before applying the power. The 
MSM5832 is a delicate circuit, and at $9 a shot, 
worth the trouble to check your work. The 
circuits are connected to the computer via 
standard edge-card connectors. 



Edge Card Connectors: What's Up? 

The 40 pin bus of the TRS-80 is a 
non-standard animal to begin with, and is not 
particularly logical in its pin assignments. 
What makes things more frustrating than 
merely locating the position of the pins, is 
trying to figure out which way is up. 

The edge card of the TRS-80, when viewed 
from its edge, has pin 1 located at the top left 
a logical place. Naturally, because the CPU 
and expansion unit face each other, the entry to 
the expansion interface is the mirror image of 
this design. Yet its top left pin is also called 
'pin 1'! So pin 1 (TRS-80) leads to pin 39 
(expansion box). 

It gets stickier than this, however. When you 
are building projects, it's likely you won't be 
doing it with professionally etched edge cards, 
but rather with headers and wires and cables of 
various kinds which you assemble yourself. So 
when you get your 40 pin edge connector to 
hook onto the TRS-80, notice - 

- the numbering of the pins on the 
connector, which, if industry standards are 
used, has pin 1 marked on the opposite side, 
like the expansion box. 

- the outside wire, which may either lead to 
pin 1 or pin 2, depending on the 
manufacturer. 

- the orientation of the connecting header, 
which may reverse the process one more 

time. 

To be absolutely sure, use a meter to 
determine the path all the way from the 
computer edge card to the final connector when 
it is mounted on the project. It's best to mount 
the header or connector first, identify its pins 
with a meter, mark them and then begin work 
wire wrapping or soldering. 



MSM5832 clock board contains only 4 integrated circuits, some 
resistors, and a crystaL Power supply is external, and includes 
rechargeable batteries for backup. 
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10 CLS : CLEAR 15D : REM • CRUDE BUT SERVICEABLE CLOCK PROGRAM 

20 FOR X = TO 6 : READ DW»(X) : NEXT : REM * ARRAY OF DAYS 

30 DATA M N A Y,T U E S D A Y,W EDNESDAY 

40 DATA THURSDAY, FRIDAY, SATURDAY, SUNDAY 

50 PRINT "ENTER HOURS AND MINUTES, PLUS AM OR PM INDICATION." 

60 INPUT "USE FORMAT 0,3,5,B,P ( = 3:58 P . M . ] " ; HQ , H1 , MD , M1 , P» 

70 INPUT "12-HOUR OR 24-HOUR CLOCK TANSWER 12 OR 24)";C« 

80 IF P$ = "P" THEtl HO = HO + 4 : REM • BIT 3 INDICATES P.M. 

90 IF C» " "24" THEN HO = HO + 8 : REM » BIT 4 FOR 24 HOURS 

10D PRINT "DAY OF THE WEEK (ENTER 1 TO 7. MONDAY IS 1.1" 

110 INPUT DW : OW = DW - 1 : REM * CLOCK'S MONDAY IS ZERO 

120 PRINT "MONTH, DAY AND YEAR IN FORMAT 0,3,3,1,8,0 (3/31/BO)" 

130 INPUT M2,M3,D0,D1 ,Y0,Y1 : REM * LEAP YEAR TEST IN NEXT LINE 

140 LY = YO + 10 * Y1 : IF LY./4 = FIX (LY/4) THEN 00 = 00 + 4 

150 POKE 14291,128 : REM * SET UP 8255 CHIP PORTS 

180 POKE 14290,80 : REM • SET UP CLOCK TO READ TIME AND DATE 



170 Q » 142B9 

1B0 POKE 0,2 
190 POKE 
200 POKE 

210 POKE 0,8 

220 POKE 0, 10 

230 POKE 0,1 2 



REM • THIS IS CLOCK ADDRESS REGISTER 



a, 4 

0,6 



POKE Q-1.M1 : POKE Q,3 : POKE 0.-1, MO 

POKE Q-1.H1 : POKE Q,5 : POKE 0,-1, HO 

POKE Q-1,DW : POKE Q,7 : POKE Q-1 , D1 

POKE Q-1, DO : POKE 0,9 : POKE Q-1.M3 

POKE Q-1,M2 : POKE 0,11 : POKE 0-1, Y1 

POKE Q-1,Y0 : REM • TIME AND DATE INFO SET 

240 POKE 14291,144 : CLS : REM » DISPLAY SUBROUTINE FOLLOWS 

250 PRINT « 0, »■) : REM » DISPLAY IS ON TOP LINE OF SCREEN 

260 POKE 14290,32 : HEM • SET UP CLOCK TO WRITE TIME AND DATE 



270 POKE 0,6 

280 POKE Q,10 

290 POKE Q,9 

300 POKE 0,8 

310 POKE 0,7 

320 POKE 0,12 

330 POKE Q, 11 

340 POKE 0,5 

350 POKE 0,4 

360 POKE 0,3 

370 POKE 0,2 

380 POKE 0,1 

390 POKE 0,0 

400 POKE 0,5 
410 



PRINT DWI (PEEK (Q-1) AND 15)", "j 

PRINT PEEK (Q-1) AND 15; CHRK8); 

PRINT PEEK (Q-1) AND 15; "/"; 

PRINT PEEK (Q-1) AND 3; CHR«(8); 

PRINT PEEK (Q-1) AND 15; "/"; 

PRINT PEEK (Q-1) AND 15; CHR$(8); 

PRINT PEEK (Q-1) AND 15; " — "; 

PRINT PEEK (Q-1) AND 3; CHR$(8); 

PRINT PEEK (Q-1) AND 15; ":"; 

PRINT PEEK (Q-1) AND 15; CHR»[8); 

PRINT PEEK (Q-1) AND 15; ":"j 

PRINT PEEK (Q-1) AND 15; CHRJ(B); 

PRINT PEEK (Q-1 ) AND 15; 
IF (PEEK (Q-1) AND 4) « THEN PRINT 
IF (PEEK (Q-1) AND 4) = 4 THEN PRINT 



A. M. 

P. M. 



420 IF (PEEK114312) AND 1 2B ) ■ THEN 500 ELSE 250 

430 REM : THIS ROUTINE IS MUCH LONGER THAN IT NEEO BE, 

440 REM : BUT IS SET UP FOR CLARITY, NOT EFFICIENT USE 

450 REM : OF MEMORY. IT IS EASIER TO USE THE MACHINE 

460 REM : LANGUAGE SUBROUTINE FOR THIS CLOCK CIRCUIT. 

500 A$ = "" : FOR X ■ 15360 TO 15424 : At = At + CHRt[PEEK(X) ) 

510 NEXT : LPRINT A$ : GOTO 250 

Listing 8-3. BASIC program for MSM5832/8255. 



7E00 210F7E 
7E03 227741 
7E06 21BF7E 
7E09 227441 
7E0C C3CC06 



7E0F D7 
7E10 E5 
7E11 3E1B 
7E13 CD5728 



7E16 2AD440 
7E19 FD21D037 
7E1D FD360390 
7E21 CD6A7F 
7E24 FD360220 
7E28 CD6A7F 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
260 
00270 
00 280 
00290 
00300 
D0310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
004EO 
047 
04 BO 
00490 
00500 
00510 
00520 
00530 
00540 
00550 



IIHItHtlttlltltll*tltttlllllHIIH*ltlllllt*ttllllttl 

MACHINE LANGUAGE CLOCK PROGRAM FOR HSM5B32 CLOCK BOARD 
ATTACHED TO THE TRS-BO AT ADDRESS 142B8 TO 14300, USING 
THE "TIME«" FUNCTION. THIS ROUTINE IS TRANSPARENT TO 
BUT IS NOT CALLED BY THE CUSTOM INTERPRETER. HENCE, 
IT OPERATES INDEPENDENTLY FROM THE INTERPRETER PATCH. 

tnininiiitiiimiiiiniiiiiiiiiuiimiiiiiiiiiiiii) 



ORG 



7E00H 



CHANGE TO RELOCATE 



IIHIIIIIIIIIIIIHIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIH 

PATCH INTO DOS TIME$ ERROR LOCATION AND CHANGE IT 
llllllllltlllimilltllllllllllllllllllllllllllllllllll 



START OF TIME$ PROGRAM 
PATCH TIME! ?L3 ERROR 
START OF "CMD" PROGRAM 
PATCH CMD ?L3 ERROR 
SACK TO A BASIC "READY" 



iiiiiiiiiiiiiiiiiiiiiiniiiiiiiiiiiniiiiiniitiitinii 

THIS IS THE BEGINNING OF TH "TIME*" PATCH TO READ TIME. 
ROUTINE INTERCEPTS 7L3 ERROR AND CHECKS LINE'S SYNTAX. 

iiniiiiiiiiiiiiiiiiiiiiiiiiiniiiiiiiiiiiniintiinii 



LI) 


HL.STAAT1 


LD 


( 41 7 7 H ) , H L 


LD 


HL.START2 


LD 


(4174H) ,HL 


JP 


06CCH 



RST 

PUSH 

LD 

CALL 



10H 
HL 

A.1BH 
2B57H 



; BASIC HOUSEKEEPING 

; SAVE BASIC LINE POINTER 

; LENGTH OF TIMES 

; ROM STRING SPACE SETUP 



llllllllinllllllllltllltlllllllllllllltinilllllllllll 

SET UP RAH SPACE AND GET CLOCK CHIP READY TO READ TIME 

### ## tn unit iiniiiinitiiiiiii ###### ## inn in in ### 



LOCATION TO STORE TIME» 
CLOCK MEMORY ADDRESS 
SET UP 8255 CHIP PORTS 

WAIT FOR SLOW MSM5B32 
SET UP CLOCK TO READ 
WAIT FOR SLOW MSM5B32 



titttiitttititttitttiniiitiiitttiittittitittiiittiitit 

CLOCK IS READY TO READ ... NOW READ AND CREATE STRING. 
DAY OF THE WEEK IS ALPHABETIC AND WILL BE DONE FIRST. 

iiiinmnnnnimiimniimmiimiiimmiiiii 



LD 


HL, (40D4H1 


LD 


IY.37D0H 


LD 


(IY+3) ,90H 


CALL 


DELAY 


LD 


(IY+2) ,20H 


CALL 


DELAY 



To use the MSM5832 clock with the 8255 
interface adaptor, you will need to refer to both 
chips' programming information. Figure 8-(?), 
earlier in this chapter, contains the 8255 
programming parameters. Figure 8-(?) shows 
how the clock's registers are set up. 

At first, this process may appear confusing. 
What is being done? Three semi-intelligent 
electronic devices are being taught to talk to one 
another. The TRS-80 knows it wants to read and 
write to memory. The 8255 is that memory. But 
the 8255 has a mind of its own, and that mind can 
only be controlled by selecting its control 
register, telling it what purpose each of its three 
ports is to serve, and then reading and writing 
those ports. Finally, the MSM5832 also has a 
mind of its own. It will neither report nor accept 
the time until it is told what aspect of the time is 
needed, and that too is done via a control register. 

Figure 8-(?) is a flow chart which describes the 
process, and Listing 8-(?) is a BASIC program 
which fairly well describes the steps needed to 
access the MSM5832 chip, 'way down the chain. 



Eliminating the 8255 by using the second 
circuit means only one set of electronic parts 
must be taught to speak to each other. The 
TRS-80 can probe right into the MSM5832 
control register to select which aspect of the time 
and date it wishes. 

Each of the machine language programs 
presented in Listings 8-(?) and 8-(?) use the 
TIME$ and CMD commands to set and recall the 
time. To set the time and date, enter : 

CMD"MON 03/14/48 02:29 PM" 



Notice that this differs from the interrupt 
driven clock (Listing 8-(?)) in that the day of the 
week and morning - afternoon indicators must 
be given. Remember to use the punctuation and 
spacing exactly as printed here. As with the 
interrupt clock, PRINT TIME$ returns the time 
and date, and this TIME$ can be used and 
manipulated just as any other string. 



A complete description of these programs is 
given in the Supplement to this Chapter. 



Listing 8-4. Assembly program for MSM5832/8255. 
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7E2B 
7E2F 
7E32 
7E35 
7E3B 
7E3B 
7E3D 
7E40 
7E41 
7E42 
7E44 
7E46 
7E47 
7E49 



FD36D10 

CD6A7F 

FD7E00 

CD6A7F 

FD7ED0 

E607 

11757F 

3C 

3D 

2807 

0603 

13 

10FD 

1BF6 



7E4B 0603 
7E4D 1A 
7E4E 77 
7E4F 23 
7E50 13 
7E51 10FA 
7E53 3E20 
7E55 23 



7E56 
7E5B 
7E5A 
7E5C 
7E5E 
7E61 
7E64 
7E65 
7E66 
7EBB 
7E6B 
7E6D 
7E70 
7E71 
7E72 
7E74 
7E77 
7E7A 
7E7C 



1E30 

160B 

0E2F 

0E0F 

C0557F 

CD557F 

70 

23 

0E03 

CD557F 

0E0F 

CD557F 

70 

23 

160D 

CD557F 

CD557F 

3620 

23 



7E7D 
7E7F 
7E82 
7EB5 
7E88 
7E8B 
7EBE 
7EBF 
7E90 
7E92 
7E95 
7E97 
7E9A 
7E9C 
7E9D 
7E9F 
7EA2 
7EA5 
7EA7 
7EAB 
7EAA 
7EAB 



1605 

FD7201 

CD6A7F 

FD7E00 

CD6A7F 

FD7E00 

F5 

14 

0E03 

CD557F 

0E0F 

CD557F 

363A 

23 

0602 

CD557F 

CD557F 

363A 

23 

10F5 

2B 

3620 



7EAD 23 
7EAE F1 
7EAF CBb7 
7EB1 280/1 
7EB3 3650 
7E85 1802 
7EB7 3641 
7EB9 23 
7EBA 3640 
7EBC C3B42B 



7EBF 7E 
7EC0 FE22 
7EC2 C29719 



6 0056 

00570 

00580 

00590 

00600 

00610 

00620 

00630 

00640 L00P1 

00650 

00660 

00670 L00P2 

006B0 

D0690 

00700 

00710 

00720 

00730 

00740 

00750 XLOOP 

00760 YLOOP 

007 70 

07 BO 

00790 

OOBOO 

081 

0820 

00830 ; 

00B40 

O0B50 

00860 

OOB70 

00880 

00B90 

00900 

0DE1 

00920 

00930 

09 40 

00950 

00960 

00970 

009B0 

00990 

01000 

01010 

01020 

01030 

01040 

01050 

D1060 

01070 

01080 

01090 

01100 

01110 

01120 

01130 

01140 

01150 

01160 

01170 

01180 

01190 

01 200 

01210 

01220 

01230 

01240 

01250 

01260 

01270 HINSEC 

01280 

01280 

01300 

01310 

01320 

01330 

01340 ; 

01350 

01360 

01370 

01380 

01390 

01400 

0141 

01420 

01430 

01440 

01450 H0RNN6 

01460 NEXT 

01470 

01480 

01490 ; 

01500 

01510 

01520 

01530 

01540 

01550 START2 

01560 

01570 



LU 

CALL 

LO 

CALL 

LD 

AND 

LD 

INC 

DEC 

JR 

LD 

INC 

DJNZ 

JR 



1IY+1] ,6 

DELAY 

A,(IY+0) 

DELAY 

A,(IY+0) 

D7H 

DE, TABLE 

A 

A 

Z, XLOOP 

B,3 

OE 

L00P2 

L00P1 



POINT TO DAY OF WEEK 
WAIT FOR SLOW MSH5832 
GET DUMMY VALUE INTO A 
WAIT FOR SLOW CHIP ( I ) 
GET DAY OF WEEK VALUE 
MASK OFF UNUSED BITS 
POINT DE TO DAY TABLE 
IT MUST BE AT LEAST 1 
IS ACCUMULATOR ZERO? 
GO OUT OF TABLE LOOP 
NUMBER OF CHARS PER DAY 
MOVE PAST EACH CHAR 
DO IT TILL AT NEXT DAY 
CHECK FOR NEXT DAY 



1 1 lllltt III I mmimmmmimi,, ,,,,,,,,,,,, ,,,,,_ 

VALUE FOR DAY IS FOUND ... NOW TURN IT INTO LETTERS 

ttmtmtmmmmmmmummtmmmntm 

LD B.3 ; NUMBER OF CHARS TO GET 

LD A,(DE) ; CHARACTER TO TRANSFER 

L0 <HL),A ; XFER DAY NAME TO TIME$ 

INC HL J NEXT LOCATION IN TIMEt 

INC DE ; NEXT LOCATION IN TABLE 

DJNZ YLOOP ; LOOP BACK FOR NEXT CHAR 

LD (HL1.20H ; PUT SPACE AFTER DAY 

INC "L ; BUMP TIME BUFFER AGAIN 

tttmmmtttnmtmmttmmmmtmmttmtt 

DAY OF WEEK IS DONE ... NOW GET MONTH, DAY, AND YEAR 

mtimmmmmimttmmmmummttttttttt 



LD 

LD 

LD 

LD 

CALL 

CALL 

LD 

INC 

LD 

CALL 

LD 

CALL 

LD 

INC 

LD 

CALL 

CALL 

LD 

INC 



E.30H 
0,11 

B.2FH 

C.OFH 

FILLER 

FILLER 

(HL) ,B 

HL 

C,3 

FILLER 

C.DFH 

FILLER 

(HL) ,B 

HL 

D,13 

FILLER 

FILLER 

[HL] ,20H 

HL 



HEX TO ASCII DIFFERENCE 
MONTH HI PORT + 1 
SLASH ["/") CHARACTER 
MASK UNUSED PORT BITS 
GET MONTH HIGH VALUE 
GET MONTH LOW VALUE 
LOAD SLASH INTO TIMES 
BUMP TIME BUFFER BY ONE 
MASK UNUSED CLOCK BITS 
GET DAY HIGH VALUE 
MASK UNUSED CLOCK BITS 
GET DAY LOW VALUE 
PUT SLASH INTO TIHEI 
BUMP TIME BUFFER BY ONE 
YEAR HIGH VALUE + 1 
GET YEAR HIGH VALUE 
GET YEAR LOW VALUE 
VALUE FOR A SPACE 
BUMP TIME BUFFER BY ONE 



tttttmtmmmmimttmmtmmummtmm 

MONTH, DAY, YEAR DONE - NOW GET HOURS, MINUTES, SECONDS 

nmtmmmmmt tin mm mtii it t,,,,,m,,iiii 



LD 

LD 

CALL 

LD 

CALL 

LD 

PUSH 

INC 

LD 

CALL 

LD 

CALL 

LD 

INC 

LD 

CALL 

CALL 

LD 

INC 

DJNZ 

DEC 

LD 



0,5 

(IY+1) ,D 

DELAY 

A,(IY+0) 

DELAY 

A, (IY+O) 

AF 

D 

C,3 

FILLER 

C.OFH 

FILLER 

(HL) ,3AH 

HL 

8,2 

FILLER 

FILLER 

(HL) ,3AH 

HL 

MINSEC 

HL 

(HL) ,20H 



HOURS HIGH VALUE 
SET UP CLOCK CHIP PORT 
DELAY FOR B255 CHIP 
DUMMY VALUE INTO ACC. 
DELAY AGAIN FOR CHIPI 
GET HOURS HIGH VALUE 
SAVE THIS FOR AM/PM 
ACCOMMODATE SUBROUTINE 
MASK UNUSED CLOCK BITS 
GET HOURS HIGH VALUE 
MASK UNUSED CLOCK BITS 
GET HOURS LOW VALUE 
PUT A COLON IN TIME$ 
BUMP THE STRING ALONG 
NUMBER MINUTE/SEC LOOPS 
GET, CONVERT, SAVE VALUE 
GET, CONVERT, SAVE VALUE 
VALUE FOR A COLON 
BUMP TIME BUFFER BY ONE 
GO BACK FDR XIN/SEC 
BACK UP TO LAST COLON 
CHANGE TO STRING END 



,t i iitim ii iiiiii nit it iiiiiiii,,,,,!,,,,,, ,,,,,,,,,,, 

HOURS, MINUTES, SECONDS ARE DONE ... NOW FIGURE AM/PM 

##### mttmmmm i mm mt mm mm mm mi 



INC 
POP 

BIT 

JB 

LD 

JR 

ID 

INC 

LO 

JF 



HL 

AF 

2, A 

Z.MORNNG 

(HL) ,50H 

NEXT 

(HL) ,41H 

HL 

(HL) ,4DH 

2BB4H 



BUMP TIME BUFFER BY ONE 
GET BACK HOUR HI VALUE 
CHECK AM/PM INDICATOR 
MORNING IF BIT 2=0 
PUT LETTER "P" IN PLACE 
JUMP PAST LETTER A 
PUT LETTER "A" IN PLACE 
BUMP TIME BUFFER BY ONE 
PUT LETTER "M" IN PLACE 
BACK TO BASIC ACTIVITY 



it iimiiimmiiiiiiiiiimiimimmmmiiimii 

THIS IS THE BEGINNING OF THE "CMD" PATCH TO SET TIME 
CHECK FOR TIME SETTING PARAMETERS AND SYNTAX 

m, mttmmmm mm imimtmnmt,mmm 



Bank Selecting Machine Language in 
ROM 

Warning: Before you begin construction of 
anything in this section, read the rest of the 
chapter! You might want to construct the 
complete ROM/RAM bank select system. 

Seriously, one of the most exciting aspects of 
the TRS-80 is its blank area in the memory map. 
This has been partially used in this chapter to 
install a real time clock. It can also be used to 
select machine language programs or data 
burned into ROMs. At the time of this book's 
publication, the cost of a 2K erasable, 
programmable, read only memory (EPROM) is 
less than $8. A year earlier, when these memories 
were $27 or more, this project would not have 
been practical. Now it is. 

In quantities of 100, these EPROMs are less 
than $5, which means, by using this project, 
direct access to over 200K of memory is possible 
for less than $500. But one or two of such 
memories are just as valuable. 

But first, what is an EPROM? How is it used? 
An EPROM, as its name suggests, is a memory 
which the user can program and reprogram as 
necessary. It is programmed with an EPROM 
programmer, and erased with ultraviolet light. It 
maintains its contents with the power off, just 
like the Level II ROMs themselves. It is used in 
a way even simpler than the way the TRS-80's 
RAM memory is used, and in this is found its 
great advantage: it needs but power, address and 
data lines to make its data available to the CPU. 

By using a decoded output port, one of a bank 
of these memories may be selected for use. Here 
is an example; I might want to load a special 
machine language monitor program. I know that 
program is located in ROM #26 in my ROM 
bank. I can command something like - 



OUT 31,26 

SYSTEM 

/122BB 



<ENTER> 
<ENTER> 
<ENTER> 



LD 
CP 
JP 



A,[HL) 

22H 

NZ ,1997H 



; CHAR AT LINE POINTER 

• ; is it a quote hark? 

; ?SN ERROR IF NO DUOTE 



- and my program will be loaded and active. 
Only the time for three entries has been spent; 
not even the time of the disk access. And, beyond 
that, no RAM memory need be used! 

A complete circuit for a ROM select bank is 
presented in Figure 8-14. Each of the lines 
marked 'to ROM' will select one of 256 possible 
ROMs! 
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Figure 8-14. Bank-selected ROMs. 
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7EC5 
7EC6 
7EC7 
7ECA 
7ECC 
7ECE 
7ECF 
7ED0 
7ED1 
7ED2 
7ED4 
7ED5 
7ED7 
7ED8 
7EDA 
7EDB 
7EDD 
7EDE 
7EE1 
7EE2 
7EE3 



23 

ES 

11757F 

QEOD 

0603 

E1 

E5 

1A 

A7 

2B08 

BE 

280A 

13 

10FD 

DC 

18EF 

E1 

C3971S 

S3 

13 

1DEB 



7EE5 F1 
7EE6 FD360380 
7EEA CD6A7F 
7EED FD360250 
7EF1 CD6A7F 
7EF4 79 
7EF5 FD360106 
7EF9 CD6A7F 
7EFC FD7700 



7EFF 
7F01 
7F04 
7F07 
7F09 
7F0C 
7F0E 
7F11 
7F14 
7F16 
7F17 
7F19 



7F1A 
7F1B 
7F1C 
7F1D 
7F20 
7F21 
7F22 
7F24 
7F26 
7F2B 
7F29 
7F2A 
7F2B 
7F2D 
7F2E 
7F2F 
7F31 
7F33 
7F34 



7F37 
7F39 
7F3B 
7F3C 
7F3D 
7F3E 
7F3F 
7F41 
7F43 
7F45 
7F4B 
7F4B 
7F4E 
7F51 
7F53 
7F54 



160B 

CD377F 

CD377F 

160D 

CD377F 

1605 

C01A7F 

CD377F 

0604 

23 

10FD 

09 



23 

E5 

D5 

110600 

19 

7E 

FE41 

3E04 

2001 

AF 

D1 

E1 

0602 

4F 

7E 

D630 

3BAA 

61 

C3417F 



1E30 

D602 

16 

23 

7c 

93 

3B9C 

FEOA 

309B 

FD7201 

CDBA7F 

FD7700 

CD6A7F 

10E8 

23 

C9 



015B0 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

D1670 

01680 

01690 

01700 

01710 

01720 

01730 

01740 

01750 

01760 

01770 

01780 

01790 

01800 

01810 

01820 

01B30 

01B40 

01B50 

01860 

01870 

01880 

01890 

01900 

01910 

01920 

01930 

01940 

01950 

019E0 

01970 

01980 

019 90 

02000 

02010 

02020 

02030 

02040 

02050 

02060 

02070 

02080 

02090 

02100 

02110 

02120 

02130 

02140 

02150 

02160 

02170 

021B0 

02190 

02200 

02210 

02220 

02230 

02240 

02250 

02260 

02270 

02280 

02290 

02300 

2310 

02320 

02330 

23 40 

02350 

02360 

23 70 

023B0 

23 90 

02400 

02410 

02420 

02430 

02440 

02450 

02460 

02470 

2480 

02490 

02500 

0251 

02520 

0253 

02540 

02550 

02560 

02570 

02580 

02590 



ERR0R1 
ERR0R2 
GOTONE 



INC 

POSH 

LD 

LD 

LO 

POP 

PUSH 

LD 

AND 

JB 

CP 

Jfl 

INC 

OJNZ 

INC 

Jfl 

POP 

JP 

INC 

INC 

DJNZ 



HL 

HL 

DE, TABLE 

0,0 

B,3 

HL 

HL 

A.(DE) 

A 

Z.ERR0R1 

[HL) 

Z, GOTONE 

DE 

L0.0P4 

C 

DYLOOP 

HL 

19 97H 

HL 

OE 

FINDIT 



BUMP LINE PTR. BY ONE 
SAVE THE LINE POINTER 
GET TABUE OF DAY NAMES 
THIS WILL BE COUNTER 
NUMBER OF CHARS IN OAY 
GET LINE POINTER BACK 
SAVE AGAIN FOR LOOP USE 
GET 1ST CHAR OF STRING 
EASY WAY TO SET A FLAG 
VALUE =0 ... 7SN ERROR 
CHECK IT AGAINST TABLE 
GET READY FOR NEXT CHAR 
RUN PAST VALUES FOR DAY 
BY RUNNING B TO ZERO 
NEXT DAY - BUMP COUNTER 
BACK TO NEXT DAY LOOP 
CLEAR STACK OF HL REG. 
60 TO ?SN ERROR MESSAGE 
GET NEXT CHAR FROM LINE 
BUMP TABLE VALUE ALONG 
KEEP GOING TILL DONE 



POP 


AF 




LD 


(IY+3) 


80H 


CALL 


DELAY 




LD 


(IY+2) 


,50H 


CALL 


DELAY 




LD 


A,C 




LD 


(IY+11 


,6 


CALL 


DELAY 




LD 


UY+O) 


,A 



mmmimimm ########################*###»###♦#» 

NUMERICAL VALUE FOR DAY IS IN C - PUT IT IN MSM5832 
#####################♦#####*##*»#########♦#######•'»*» 

j CLEAR STACK OF HL VALUE 

; SET UP B255 TO WRITE 

; THAT #&!*% SLOW MSM5B32 

; CLOCK CHIP WRITE VALUE 

i HDW SLOW IS IT?I? 

j GET DAY OF WEEK VALUE 

; READY TO WRITE DAY 

; WAIT (YAWN) TO WRITE 

; WRITE DAY TO CLOCK 

mtmtiinmiiiiiimuiinmniiinimiiitumtt 

DAY IS WRITTEN - FIND MONTH, DAY, YEAR AND WRITE THEM 
########»»##########»###########♦#######♦####♦*»####### 

i VALUE FOR MONTH + 1 
i WRITE MONTH TO CLOCK 
; WRITE DAY TO CLOCK 
; VALUE FOR YEAR +1 
j WRITE YEAR TO CLOCK 
; SET TO HOURS HISH VALUE 
; WRITE HOURS TO CLOCK 
; WRITE MINUTES TO CLOCK 
i NUMBER OF CHARS LEFT 
; BUMP LINE POINTER 
i LOOP PAST "PM" & OUOTES 
; BACK TO BASIC PROGRAM 

itmtimmmmtimmmmmmmmmmmt 

CHECK FOR AM OR PM INDICATION AND WRITE THAT VALUE 
####*###♦#######*##################♦#*##########»♦##### 



LD 


D,11 


CALL 


TIMSET 


CALL 


TIMSET 


LD 


D,13 


CALL 


TIMSET 


LD 


0,5 


CALL 


AMORPM 


CALL 


TIMSET 


LD 


8,4 


INC 


HL 


DJNZ 


SNEAK 


RET 





INC 

PUSH 

PUSH 

LD 

ADD 

LD 

CP 

LD 

JR 

XOR 

POP 

POP 

LD 

LD 

LD 

SOB 

JR 

ADD 

JP 



HL 

HL 

DE 

DE,6 

HL.DE 

A, [HD 

41 H 

A, 4 

NZ.EVENNG 

A 

OE 

HL 

B,2 

C,A 

A,[HL) 

3 ON 

C.ERR0R1 

A,C 

MIDDLE 



BUMP LINE TO NEXT CHAR. 
SAVE CURRENT LINE PTR. 
SAVE OTHER VALUES IN DE 
HOW MANY SPACES TO HOVE 
FIND AM OR PM IN LINE 
GET CHARACTER FROM LINE 
SET FLAG IF CHAR. = "A" 
GET PM INDICATOR READY 
ZERO FLAG NOT SET IF PM 
CLEAR PM INDICATOR 
RESTORE VALUES TO DE 
GET ORIGINAL LINE PTR. 
SET UP B AS TIMSET LOOP 
SAVE AH/PM INDICATOR 
GET VALUE FROM LINE 
STRIP ASCII MASK 
ERROR IF LESS THAN 
ADD AM/PM BIT TO VALUE 
SUBROUTINE FINISHES JOB 



nmimmmmmmmmmmmmmmmmt 

TIME SETTING SUBROUTINE CHECKS LINE FOR SYNTAX 

mmmmmtmmmmmmmnmmmmmi 



LD 
LD 
DEC 

INC 

LD 

SU8 

Jfl 

CP 

JR 

LD 

CALL 

LD 

CALL 

DJNZ 

INC 

RET 



E.30H 

B,2 

D 

HL 

A,(HL) 

E 

C.ERR0R1 

OAH 

NC,ERR0R1 

HY+1J,D 

DELAY 

(IY+0) ,A 

DELAY 

ZLOOP 

HL 



CONVERTS ASCII TO HEX 
LOOP TWICE FOR 2 DIGITS 
BUMP CLOCK ADDRESS PORT 
GET NEXT CHAR FROM LINE 
MOVE IT TO ACC. TO TEST 
STRIP OFF ASCII VALUE 
ERROR IF LESS THAN 
CHECK IF GREATER THAN 6 
ERROR IF GREATER THAN 9 
OPEN POflT TO CLOCK 

THE USUAL CMOS WAIT 
WRITE VALUE TO CLOCK 
WAIT I WAIT I WAIT I I I I I 
DO IT FOR 2 DIGITS 
BUMP PAST / : OR SPACE 
BACK TO MAIN PROGRAM 



mmmmmmmmmmimmmmmmmm 

GET VALUE, CONVERT TO ASCII, AND SAVE IN TIME* BUFFER 

iimmmmmmmmmimmmmmmimm 



Actually, the bank-select ROM idea is only 
one part of a larger possibility — blocks of ROM 
and/or RAM placed interchangeably. Ideally 

the additional RAM would be available in 
higher memory, but the TRS configuration is so 
locked into its memory map that expansion in 
high memory would require major reconfiguring 
of the memory and refresh circuits. With that in 
mind, then, all this expansion will be dedicated 
to the free area located at 3000 to 37E0. 

This memory addition is an application of a 
'Read-Only-RAM' concept. Simply stated, the 
memory write (WR) line to read/write memory is 
disabled by the user in order to outline an area of 
protected, but not permanently programmed, 
memory. Machine language programs under 
development can be emulated with this system. 
Crucial software can be embedded in crash- 
proof RAM, and the occasional nuisance of a 

program gone wild will not affect data in this 
area. 

The inclusion of bank selection in this area 
permits the use of interchangeable, and 
constantly on-line, blocks of ROM, RAM, and 
protected RAM. In Figures 8-16 and 8-17, the 
ROMs used, as before, are 2716 EPROMs, and 
the RAMs are of the static variety. Two designs 
of the circuit are shown: one uses 2114 static 
RAMs, which are IK by 4 bits wide; the other 
uses 4118 static RAMs, each a full IK by 8 bits 
wide. The former memories are considerably 
less expensive, but the latter are easier to wire in 
a wire-crazy bank select scheme like this one. 

As before, output port 31 has been chosen for 
the memory, and each 2K block is selected by the 
value output through port 31. Furthermore, 
RAM data in the unselected blocks remains 
intact, ready to use whenever a different value is 
output through port 31. 

The bank-selected ROM may be used for the 
most part as any other memory, with one very 
interesting exception: routines in different 
ROMs may not call or jump to each others' 
routines in the normal way. Instead, two special 
routines must be used. 

The jump routine is the simplest: the ROM's 
position in the bank must be identified, the jump 
prepared and the OUT statement commanded. 
The easiest way to do this is shown in Listing 

8-7); the AF and HL registers are saved on the 
stack, then AF is loaded with the location of the 
routine (which it must obtain from a table of 
some sort identical in each ROM). Following 
that, the HL register pair is loaded with the jump 
address, and the OUT (1F),A command is then 
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7F55 15 
7F56 FD7201 
7F59 CD6A7F 
7F5C FD7E00 
7F5F CD6A7F 
7F82 FD7E00 
7FB5 A1 
7F66 83 
7F67 77 
7FB8 23 
7F68 C8 



7F6A C5 
7F6B F5 
7F6C 010108 
7FBF CD6000 
7F72 F1 
7F73 C1 
7F74 C9 



7F75 4D 
7F7B 54 
7F7B 57 
7F7E 54 
7FB1 46 
7F84 53 
7F87 53 
7F8A 00 



7E00 

00000 TOTAL 



026 00 
02810 
02620 
02630 
026 40 
265C 
02660 
02670 
26 BO 
26 90 
02700 
2710 
02720 
02730 
27 40 
02760 
27 60 
27 70 
27 BO 
27 90 
280 
02810 
02820 
02830 
02840 
02850 
02B60 
02870 
28 80 
02890 
02900 
02910 
02920 
02830 
02940 
02950 
02960 
02970 
028B0 
02990 
03000 
03 010 
03020 
03030 
03 040 
03050 
ERRORS 



DEC 
LD 

CALL 
LD 

CALL 
LD 

AND 
ADD 

LD 
I N C 
RET 



D 

IIY-H) ,D 

DELAY 

A,(IY+0! 

DELAY 

A,[IY+0) 

C 

A,E 

IHL] ,A 

HL 



BUMP CLOCK PORT ADDRESS 
POINT TO VALUE WANTED 
THAT OL' SLOW HSM5B32 
SET DUMMY VALUE INTO A 
WAIT AGAIN! SLOW CHIP 
NOW GET VALID VALUE 
MASK UNUSED BITS 
MAKE IT AN ASCII VALUE 
PUT VALUE INTO BUFFER 
NEXT BUFFER POSITION 
BACK TO MAIN PROGRAM 



it iiiiiiiiiitntiiiititiiitittittiitittiitniittititiit 

THIS IS A SETUP WHICH CALLS A DELAY SUBROUTINE IN ROM 

it iititiiimtitiiiiiiitiitttitiifitiitiiittmittitiii 

; SAVE BC REGISTER PAIR 
; SAVE AF REGISTER PAIR 
; DELAY FOR MSM5832 CHIP 
I HERE IS ROUTINE IN ROM 
; GET AF REGISTERS BACK 
; GET BC REGISTERS BACK 
i BACK TO MAIN PROGRAM 

innntiitiiiitttiitiittiniiiiiitiiitiiiiinin intii 

THIS IS THE LOOKUP TABLE OF DAYS OF THE WEEK 

tiiiiiiiiiiiiiiiiiiiiiiiiiiimtiiiiiiiiiiitiiiiititin 



PUSH 


BC 


PUSH 


AF 


LD 


BC,1 


CALL 


0060H 


POP 


AF 


POP ' 


BC 


RET 





ABLE DEFM 



' MON ' 



DEFM 


'WED 


DEFM 


'THU 


DEFM 


'FRI 


DEFM 


'SAT 


DEFM 


'SUN 


DEFB 






II 1 1 III llltlt II II til III I III I lllllllllltltll It l,,l III III 

END ENTRY 
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executed, which switches ROMs. The proper 
jump address is still in HL, so a simple JP (HL) 
effects the jump. 



ROUTINE BEING LEFT MUST PROVIDE THIS 
INFORMATION TO AF AND HL REGISTERS 



..zzzz 


LD 


(ZZZZ) ,A 


SAVE AF VALUES 


..YYYY 


LD 


(YYYY] ,HL 


SAVE HL VALUES 


3ENN 


LD 


A,NN 


NEW ROM BANK NUMBER 


21NNNN 


LD 


HL.NNNN 


JUMP ADDRESS 


C3WWWW 


JP 


XFER1 


MAKE ROM TRANSFER 




i ALL 


ROMS CONTAIN THE FOLLOWING IDENTICAL 




; BYTES AT THE SAME ADDRESSES IN ROM 


D31F XFER1 OUT 


(1FJ,A 


SWITCHES ROMS 


ES 


JP 


(HL) 


JUMPS TO ROUTINE 


..ZZZZ 


LD 


(ZZZZ) ,A 


NOT USED IN JUMP 


..XXXX 


LD 


A, (XXXX) 


NOT USED IN JUMP 


D31F 


OUT 


(1F),A 


NOT USED IN JUMP 


C9 


RET 




NOT USED IN JUMP 




; ALL 


ROUTINES BEING ENTERED MUST PROVIDE 




; THE 


FOLLOWING RESTORATION CODING 


..ZZZZ 


LD 


HL.IZZZZ) 


RESTORE HL VALUES 


..YYYY 


LD 


A, (YYYY) 


RESTORE AF VALUES 



Listing 8-6. Accessing multiple ROMs (jumps). 



Calling a subroutine in another ROM is more 
complicated, but still can be done. Listing 8-(?) 
shows how it might be achieved. 



; ROUTINE BEING LEFT MUST PROVIDE THIS 
; INFORMATION IN AF AND HL REGISTERS 



..ZZZZ 


LD 


(ZZZZ) ,A 




; SAVE AF DATA 


..YYYY 


LD 


(YYYYl.HL 




; SAVE HL DATA 


DB1F 


IK 


A,(1F) 




; GET ROM BANK NUMBER 


..XXXX 


LD 


(XXXX) ,A 




; SAVE ROM BANK NO. 


21NNNN 


LD 


HL.NNNN 




J GET CALL ADDRESS 


CDWWWW 


CALL 


XFER2 




; MAKE ROM TRANSFER 




J THE 


FOLLOWING CALLING 


ROUTINE MUST BE 




; PLACED IN ALL ROMS 


AT 


IDENTICAL LOCATION 


D31F XFER2 


OUT 


(1F),A 




; SWITCH ROMS 


E9 


JP 


(HL) 




; ENTER ROUTINE 


..ZZZZ BACK 


LD 


(ZZZZ) ,A 




; SAVE AF DATA 


..XXXX 


LD 


A, (XXXX) 




; GET OLD ROM NO. 


D31F 


OUT 


I1F),A 




; TRANFER BACK 


C9 


RET 






; BACK TO CALLER 




; THE 


CALLED ROUTINE 


MUST MAKE THE 




; FOLLOWING IDENTIFICATIONS 


..YYYY 


LD 


HL.IYYYY) 




; GET SAVED DATA 


..ZZZZ 


LD 


A, (ZZZZ) 




; GET SAVED DATA 




; EXECUTE SUBROUTINE 


FOUND HERE 




; PERFORM FOLLOWING 


STEPS WHEN THE 




; SUBROUTINE IS COMPLETE AND MUST RETUHN 


C3 WW 


JP 


BACK 




; GO TO XFER ROUTINE 



Listing 8-7. Accessing multiple ROMs (calls). 



This bank-select method is only one of many 
options which may be selected to move from one 
ROM to another; as you can see, three bytes of 
RAM (marked ZZZZ, YYYY and WWWW in 
the listings) are needed to store information 
between transfers. Although this process may 
initially seem unwieldy, a ROM-resident 
operating system in each one, together with 
cautious programming, will provide a 
remarkably transparent system expansion. 
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Figure 8-16. Bank-selected 41 18 ROM/RAM. 
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Figure 5-7 7. ROM/RAM addition without bank-select 
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Completed ROM/RAM addition with power supply on board 
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00100 


; MEMORY SIDECAR TEST TAPE (C) 1981 D. B. KITSZ 






00110 


; 






3C00 




001 20 




ORG 


3C0OH 


3C00 


2A 


00130 




DEFM 


'•* LOADING 2K RAM TEST TAPE ' 


3C1C 


2D 


00140 




DEFM 


'— 0. B. KITSZ, SEPTEMBER 1981 ••' 


3000 




00150 




ORG 


3000H 


3000 


2A 


00160 


Ml 


DEFM 


■ •**«•*•*••*•«••*••***•**••*•***» i 


3020 


2A 


00170 




DEFM 


'******•***»**•******»♦*•*»**•♦»* t 


3040 


2D 


00180 


M2 


DEFM 




Ih&llnb HcAU— ONLY 


3060 


2D 


00190 




DEFM 
DEFM 


1 nrtH" ymnnv nnra ■ 


3080 


54 


00200 


M3 


'THIS SCREEN HAS BEEN LOADED DIRE' 


30A0 


43 


00210 




DEFM 


'CTLY FROM THE MEMORY SIDECAR. IF' 


30C0 


41 


00220 


H4 


OEFM 


'ALL CHARACTERS ARE CORRECT IN TH' 


30E0 


49 


00230 




DEFM 


'IS MESSAGE, AND IT HAS LOADED ON' 


3100 


54 


00240 


H5 


DEFM 


'THE SCREEN NORMALLY, THEN THIS F' 


3120 


45 


00250 




DEFM 


'IRST TEST OF YOUR MEMORY SIDECAR' 


3140 


49 


00260 


Me 


DEFM 


'IS COMPLETED. BELOW IS SHOWN A ' 


3160 


43 


00270 




DEFM 


'COMPLETE CHARACTER SET AVAILABLE' 


31 BO 


54 


002B0 


M7 


DEFM 


'TO YOUR TRS-80: ' 


31A0 


20 


00290 




DEFM 


• i 


31 CO 


0001 


00300 


KB 


DEFW 


0100H 


31C2 


0203 


00310 




DEFW 


0302H 


31C4 


0405 


00320 




DEFW 


05D4H 


31 C6 


0607 


00330 




DEFW 


0706H 


31C8 


0809 


00340 




DEFW 


0908H 


31CA 


OAOB 


D0350 




DEFW 


OBOAH 


31CC 


OCOD 


00360 




DEFW 


ODOCH 


31CE 


OEOF 


00370 




DEFW 


OFDEH 


3100 


1011 


00380 




DEFW 


1110H 


31D2 


1213 


00390 




DEFW 


1312H 


3104 


1415 


00400 




DEFW 


151 4H 


3106 


1617 


00410 




DEFW 


1716H 


31 DB 


1B19 


00420 




DEFW 


191BH 


31 DA 


1A1B 


00430 




DEFW 


1B1AH 


31 DC 


1C1D 


00440 




DEFW 


1D1CH 


31 DE 


1E1F 


00450 




DEFW 


1F1EH 


31 EO 


2021 


00460 




DEFW 


2120H 


31 E2 


2223 


00470 




DEFW 


2322H 


31 E4 


2425 


00480 




DEFW 


2524H 


31 E6 


2627 


00490 




OEFW 


2726H 


31 EB 


2829 


00500 




OEFW 


2928H 


31EA 


2A2B 


00510 




DEFW 


2B2AH 


31 EC 


2C2D 


00520 




DEFW 


2D2CH 


31 EE 


2E2F 


00530 




DEFW 


2F2EH 


31F0 


3031 


00540 




DEFW 


3130H 


31F2 


3233 


00550 




DEFW 


333 2H 


31F4 


3435 


00560 




DEFW 


353 4H 


31F6 


3637 


00570 




DEFW 


3736H 


31F8 


3B39 


00580 




DEFW 


3938H 


31FA 


3A3B 


00590 




DEFW 


3B3AH 


31FC 


3C3D 


00600 




DEFW 


3D3CH 


31FE 


3E3F 


00610 




DEFW 


3F3EH 


3200 


4041 


006 20 


H9 


DEFW 


4140H 


3202 


4243 


00630 




DEFW 


4342H 


3204 


4445 


00640 




DEFW 


4544H 


3206 


4647 


00650 




DEFW 


4746H 


320B 


4849 


00660 




DEFW 


4948H 


320A 


4A4B 


00670 




DEFW 


4B4AH 


320C 


4C4D 


006 80 




DEFW 


404CH 


320E 


4E4F 


00690 




DEFW 


4F4EH 


3210 


5051 


00700 




DEFW 


515DH 


3212 


5253 


00710 




DEFW 


5352H 


3214 


5455 


00720 




DEFW 


5554H 


3216 


5657 


00730 




DEFW 


5756H 


321 B 


5659 


00740 




DEFW 


5958K 


321A 


5A5B 


00750 




DEFW 


5B5AH 


321C 


5C5D 


0D760 




DEFW 


5D5CH 


321 E 


5E5F 


00770 




DEFW 


5F5EH 


3220 


6061 


00780 




DEFW 


6160H 


3222 


6263 


00790 




DEFW 


6362H 


3224 


6465 


00800 




DEFW 


656 4H 


3226 


6667 


00610 




DEFW 


676BH 


322B 


6869 


O0B20 




DEFW 


6968H 


322A 


6A8B 


00030 




DEFW 


6B6AH 


322C 


6C6D 


006 40 




DEFW 


6D6CH 


322E 


6E6F 


00850 




DEFW 


6F6EH 


3230 


7071 


00B60 




DEFW 


7170H 


3232 


7273 


00870 




DEFW 


7372H 


3234 


7475 


00680 




DEFW 


7574H 


3236 


7677 


00890 




DEFW 


7776H 


3238 


7879 


00900 




DEFW 


7978H 


323A 


7A7B 


0091 




DEFW 


7B7AH 


323C 


7C7D 


00920 




DEFW 


7D7CH 


323E 


7E7F 


00930 




DEFW 


7F7EH 


3240 


8081 


00940 


MID 


DEFW 


61 BOH 


3242 


8283 


00950 




DEFW 


8382H 


3244 


B485 


00960 




DEFW 


85B4H 


3246 


B6B7 


00970 




DEFW 


8786H 


3246 


B889 


00980 




OEFW 


B98BH 


324A 


BABB 


00990 




DEFW 


8B6AH 


324C 


BC8D 


01000 




DEFW 


8D8CH 


324E 


BE8F 


01010 




DEFW 


BF8EH 



Remember also that the ROMs do not need to 
call each other directly. Instead, you may want to 
establish a lookup and transfer table in RAM, 
that acts like this : 

1. User is in BASIC. 

2. OUT 31,0 is entered to select the master 
ROM. 

3. SYSTEM is entered, followed by /12288. 

4. The master ROM (ROM #0) may be 
programmed to reset MEMORY SIZE and 
relocate a bank of patch points into RAM. 

5. The master ROM, having completed its 
work the way Level II does at power up, 
returns to a READY in BASIC. 

6. The routines are now all ready to use. 



In summary, the ROM, RAM and bank-select 
systems can extend the horizons of your TRS-80 
in unique ways. A project for people afflicted 
with cerebral palsy is developing a system 
whereby patients, doctors, or nurses need not be 
concerned if the TRS-80 crashes at some point, 
or the power is removed. Instead of loading tapes 
or fumbling with disks that may get damaged 
through handling or erratic power, these people 
need only use their bank-selected ROMs to 
reinstate and activate the machine language 
programs which drive specially made hardware. 
This hardware permits them to communicate 
with and use the computer with great ease. 

Without the bank-select feature, however, the 
8K control programs would have to be reloaded 
regularly, at a cost of time and patience, plus the 
risk of damage, loss or failure. 
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3250 9081 
3262 9283 
3264 8486 
3256 9687 

3258 9889 
326A SA8B 
326C 8C9D 
326E 9E9F 
3260 A0A1 
3262 A2A3 
3264 A4AS 
3266 A6A7 
3268 ASAS 
326A AAAB 
326C ACAD 
326E AEAF 
3270 B0B1 
3272 B2B3 
3274 B4B5 
3276 8687 
3278 B8BS 
327A BABB 
327C BCBD 
327E BEBF 
3280 C0C1 
3282 C2C3 
3284 C4C5 
3286 C6C7 
3288 C8CS 
32BA CACB 
32BC CECD 
328E CECF 
3290 D0D1 
3292 D2D3 
3294 0405 
3296 06D7 
329B 0BD9 
329A OAOB 
329C DCDD 
329E OEOF 
32A0 E0E1 
32A2 E2E3 
32A4 E4E5 
32A6 E6E7 
32A8 E8E9 
32AA EAEB 
32AC ECED 
32AE EEEP 
32B0 F0F1 
32B2 F2F3 
32B4 F4F5 
32B6 F6F7 
32B8 F8F8 
32BA FAFB 
32BC FCFD 
32BE FEFF 
32C0 20 
32E0 20 
3300 57 
3320 43 
3340 43 
3360 46 
3380 20 
33AB 20 
33C0 2A 
33E0 2A 

3400 2A 
3420 2A 
3440 2D 
3460 20 
3471 54 
3481 20 
34B1 32 

3401 20 
34F1 53 
3511 4F 
3531 47 
3551 44 
3571 20 
3575 211640 
3578 36E3 
3S7A 23 
357B 3603 
357D 210030 
3680 11003C 
3583 010004 
3586 EOBO 
35BB 3A403B 
35BB A7 
358C 28FA 
358E CDA435 
3591 2634 
3583 163C 



01020 
01030 
01040 
01050 
01060 
01070 
01080 
01080 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
01170 
01180 
01190 
01200 
01210 
01220 
01230 
01240 
01250 
01260 
D1270 
01280 
01290 
01300 
01310 
01320 
01330 
01340 
01350 
01360 
01370 
01380 
01390 
01400 
01410 
01420 
01430 
01440 
01450 
01460 
0147D 
01480 
01490 
01500 
01510 
01520 
01530 
01540 
01550 
01560 
01570 
01560 
01590 
01600 
01610 
01620 
01630 
01640 
01650 
01660 
01670 
01680 
01690 
01700 
01710 
01720 
01730 
01740 
01750 
01760 
01770 
01780 
01790 
01800 
01810 
01620 
01830 
01840 
01850 
01860 
01870 
01880 
01890 
01900 
01910 
01920 
01930 
01940 



HIS 

Ml 3 

M14 
HIE 

M16 

M1A 
H2B 
M3A 

IMA 

M5A 

M6A 

M7A 
ENTRY 

BACKUP 



DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

OEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

OEFW 

OEFW 

OEFW 

DEFW 

OEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

OEFW 

OEFW 

DEFW 

DEFW 

OEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

OEFW 

DEFW 

OEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

OEFW 

DEFW 

DEFH 

DEFM 

DEFM 

DEFM 

DEFM 

DEFM 

DEFM 

DEFM 

DEFM 

DEFM 

DEFM 

DEFM 

OEFM 

DEFM 

DEFM 

DEFM 

DEFM 

DEFM 

OEFM 

DEFM 

DEFM 

DEFM 

DEFM 

LD 

LD 

INC 

LD 

LD 

LD 

LD 

LOIR 

LD 

AND 

JR 

CALL 

LD 

LD 



9190H 

9392H 

8684H 

8796H 

9898H 

9BSAH 

8D9CH 

9F8EH 

0A1A0H 

0A3A2H 

0A5A4H 

0A7A6H 

OASABH 

OABAAH 

OAOACH 

OAFAEH 

OBI BOH 

0B3B2H 

0B5B4H 

0B7B6H 

D69B8H 

OBBBAH 

OBDBCH 

OBFBEH 

0C1C0H 

0C3C2H 

0C5C4H 

0C7C8H 

0C9C8H 

OCBCAH 

OCOCEH 

OCFCEH 

0D1DOH 

0D3D2H 

0D504H 

0D7D6H 

0D9DBH 

ODBDAH 

OODOCH 

ODFDEH 

0E1E0H 

0E3E2H 

0E5E4H 

0E7E6H 

0E9E8H 

OEBEAH 

OEDECH 

OEFEEH 

0F1F0H 

0F3F2H 

0F5F4H 

0F7F6H 

0F9F8H 

OFBFAH 

OFDFCH 

OFFFEH 



•WHEN YOU HAVE VERIFIED THAT ALL ' 
'CHARACTERS HAVE BEEN TRANSFERRED' 
'CORRECTLY TO THE SCREEN, PRESS T' 
'HE <ENTER> KEY TO CONTINUE ' 






-RAM 1 



TESTING "READ-ONLY' 

MEMORY CONT'D ' 



'THIS SECOND SCREEN OF CHARACTERS' 
' IS FOUND IN THE SECOND GROUP OF' 
cK RANDOM ACCESS MEMORY CHIPS IN' 
' THE MEMORY SIDECAR. THE SCREEN' 
'SHOULD BE AS CLEAN AS THE FIRST ' 
'ONE WITH THE EXCEPTION OF AN 000' 
'GROUP OF CHARACTERS PRINTED IMME' 
'DIATELY BELOW THIS LINE — ■ 

HL.4016H 
IHLl.OESH 

HL 

(HU.03H 

HL.3000H 

DE.3C00H 

BC.400H 

A,(3640H] 
A 

Z.L00P1 
DELAY 

H.34H 
D.3CH 



Romplus and Other ROM Extenders 

There are simpler methods of adding ROM 
to the TRS-80, where some of the work has 
already been done for you. The Micro 80 
Computer Club of Ontario (in care of Brian 
Harron, 67-3691 Albion Road, Ottawa, Ontario 
KIT 1P2) has produced their Romplus board, 
capable of handling two 2708 IK ROMs or one 
2716 2K ROM. It fits inside the keyboard, and 
only requires soldering three integrated circuits 
in place on the board, plus sockets for the 
ROMs. 

Computer Accessory Technology (1307 Bagley 
Drive, Kokomo, Indiana 46901) has also 
developed a small board which contains a single 
2716 EPROM and an address decoder. It comes 
caseless, but has a power supply and plugs 
direcly into the TRS-80 edge-card connector. A 
set of programmed ROMs is available which 
include utilities of different kinds. 




Personal Micro Computers (475 Ellis Street, 
Mountain View, California 94043) makes the 
REX-80 ROM extender, which is similar to the 
C.A.T. board, but comes with case and power 
supply, plus edge connector and cable. They 
also provide programmed ROMs. About $50 for 
the device, $25 for the ROMs. 

Finally, The Peripheral People (P.O. Box 524, 
Mercer Island, Washington 98040), offers the 
Memory Sidecar ROM/RAM addition, which I 
designed, and is identical to the ROM/RAM 
addition presented in this book, without any 
bank-select features. The complete unit is $149, 
and a blank board is $25. 
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3595 


0604 


01950 




LD 


B,4H 


3597 


EOBO 


01960 




LOIR 




3599 


3A4038 


01970 


L00P2 


LD 


A,(3B40H) 


359C 


A7 


01980 




AND 


A 


359D 


28FA 


01990 




JR 


Z,L00P2 


359F 


C0A435 


02000 




CALL 


DELAY 


35A2 


18D9 


02010 




JR 


BACKUP 


35A4 


010040 


02020 


DELAY 


LD 


BC,4000H 


35A7 


OB 


02030 


L00P3 


DEC 


BC 


35A8 


78 


02040 




LD 


A,B 


35A9 


B1 


02050 




OH 


C 


35AA 


2QFB 


02060 




JR 


NZ.L00P3 


35AC 


C9 


02070 




RET 




35A0 


BO 


02060 




DEFH 


i i 


asm 


20 
2D 
20 


02090 
02100 
02110 


MHA 
M9A 


DEFM 
DEFM 
DEFM 




35D1 




35F1 


' - WHICH IS THE ACTUAL BLOCK' 


3611 


20 


02120 




DEFM 


' OF MACHINE CODE THAT IS RUNNING' 


3631 


54 


02130 


M1QA 


DEFM 


'THIS TEST PROGRAM. TO EXIT THIS' 


3651 


20 


02140 




DEFH 


' ROUTINE, YOU HUST PRESS RESET.' 


3671 


54 


02150 


H11A 


DEFM 


'TO REPEAT THE TEST SEQUENCE, PRE' 


3691 


53 


02160 




DEFM 


'SS THE <ENTER> KEY. • 


36 B1 


20 


02170 


M12A 


DEFM 




36 D1 


2U 


02180 




DEFM 




36F1 


54 


02190 


H13A 


DEFM 


'THE UNUSUAL LINES SEEN HERE ARE ' 


3711 


41 


02200 




DEFM 


'A REPRESENTATION OF MEMORY SPACE' 


3731 


55 


02210 


H14A 


DEFM 


'USED BY THE TRS-80 TO CONTROL TH' 


3751 


45 


02220 




DEFM 


'E DISK DRIVES AND CASSETTE PORT:' 


3771 


20 


02230 




DEFM 




3791 


20 


02240 




DEFM 




37B1 


20 


02250 




DEFH 




3C40 




02260 




ORG 


3C40H 


3C40 


2A 


02270 




DEFH 


'»» LOADING 2K RAM TEST TAPE COM' 


3C5F 


50 


02280 




DEFH 


'PLETE. CONTROL TAKEN BY TEST ••' 


4016 




02290 




ORG 


4016H 


4016 


7535 


02300 




DEFW 


ENTRY 


3575 




02310 




END 


ENTRY 


00000 TOTAL 


ERRORS 








29944 TEXT AREA BYTES LEFT 




BACKUP 357D 


01850 


02010 






DELA 1 ! 


35A4 


02020 


01920 


02000 




ENTRY 3575 


01810 


02300 


02310 




L00P1 


3588 


01890 


01910 






loop; 


3599 


01970 


01990 






loop; 


35A7 


02030 


02060 






Ml 


3000 


00160 








H10 


3240 


00940 








MICA 


3631 


02130 








M11 


3280 


01260 








M11A 


3671 


02150 








H12 


32C0 


01580 








mat 


36B1 


02170 








M13 


3300 


01600 








HI3A 


36F1 


02190 








M14 


3340 


01620 








H14A 


3731 


02210 








H15 


3380 


01640 








HI 6 


33C0 


01660 








MIA 


3400 


01680 








M2 


3040 


00180 








M2B 


3440 


01700 








M3 


3080 


00200 








M3A 


3471 


01720 








M4 


30C0 


00220 








M4A 


34B1 


01740 








Kb 


3100 


00240 








NBA 


34F1 


01760 








M6 


3140 


00260 








HbA 


3531 


01780 








M7 


3180 


00280 








M7A 


3571 


01800 








M8 


31C0 


00300 








MBA 


35B1 


02090 








M9 


3200 


00620 








M3A 


35F1 


02110 









A Front Panel Monitor 

The first personal computers were a hobbyist's 
dream and a user's nightmare. These large boxes 
of electronic boards were programmed by hand, 
one byte at a time. The operation of the 
processor was stopped, an address was selected, 
and a byte programmed — all by using nearly 30 
switches. 

The TRS-80 is a far cry in size, speed, power, 
and convenience from these early machines (but 
don't forget that 'early' means 1974!). Yet there 
was an advantage in these early machines that 
the TRS-80 and its kin don't have: the front 
panel display. The front panel not only contained 
the multiple switches, but also a bank of LEDs so 
the user could view the contents of memory, 
registers, etc. (see Photo 8-2. ). 

The front panel is not an entirely obsolete 
concept, and can be remarkably valuable when 
your machine language programs sprint for the 
exit when you're not looking. Since the front 
panel visually monitors addresses and data, it 
provides somewhat of a window opening on the 
computer's activities. 

The front panel can tell you if the machine is 
caught up in a deadly tight loop, if it is still 
processing (have you ever waited while the 
computer sorted string data?), or if it is operating 
in the area you expect it to. You can follow 
peripheral accesses like printers and disk, sound 
output routines and special devices you may have 
created. 

Figure 8-18 presents the circuit for the micro 
front panel. It is no more than a group of latches 
which are activated by certain conditions - you 
may select any combination of input, output, 
read or write signals to trigger the LED displays. 
16 LEDs monitor the address, and eight monitor 
the data. 

The latches are triggered on an upswing of any 
signal line that is switched into the select gate; 
the gate may be switched off entirely, leaving the 
last latched address displayed on the LEDs. 

Ideally, the front panel can be created from 
subminiature, 'grain of wheat' LEDs, and 
mounted directly in the TRS-80 case and 
soldered in place. Alternatively, it may be 
connected when needed by a standard 40 
conductor cable. Method of construction is not 
critical, and can use soldering and wire wrap. 
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A Front Panel Monitor 




Photo 8- 1 . DEC front panel 




Photo 8-2. Micro front panel. 

Micro front panel monitor shows data and address lines from 
read, write, input, or output conditions. 




When using the micro front panel, you'll notice 
that much of the activity, particularly memory 
reads, run by very fast. It can't be helped. 
Because the TRS-80 uses dynamic memory 
which must be refreshed every few thousandths 
of a second (see description earlier in this 
chapter), the instruction clock cannot be 
stopped. Thus, you'll have to get used to the fast 
operation, noting from the intensity of the LEDs 
the frequency with which an area of memory is 
accessed. The monitor is remarkably useful when 
running diagnostic routines, because it points out 
whether there are any obvious signal line flaws. If 
the diagnostic program is a tight loop (most are - 
see chapter 10), then the activities of the 
computer's signal lines will become very obvious 
on the micro front panel. 

In any case, it's easy to build and nifty to watch 
- very instructive to see how the computer 
accesses disks, for example, or how one data line 
pulses during cassette input/output. 



Micro front panel can be plugged directly into the edge card or 
put at the end of a connector cable, as shown here. 
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Figure 8-18. Micro front panel 
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Keeping It Safe: Mass Storage 

Mass storage for computer programs and data 
has evolved from the days of punched paper tape 
and punch cards to present systems involving 
magnetic disk storage and bubble memories. 

For microcomputer users, mass storage 
presents a unique problem: slow and apparently 
unreliable tape systems are inexpensive but 
frustrating, whereas fast disk-based systems 
seem transparent, trouble free, and expensive. 
Both of these generalizations border on myth. 

What are the true advantages and 
disadvantages of the competing systems? This 
chapter will cover them in some detail, but 
briefly, here they are: 

1. Cassette tape is a slow to medium speed 
storage medium (500 bits per second is 
normal for the TRS-80, with systems capable 
of transferring data at more than 3000 bits 
per second). 

2. Tape is an inexpensive storage medium 
(3/1000 of a cent per bit), and is available 
across the counter. The hardware is 
pre-configured on the TRS-80, and the 
operating system (such as it is) is in ROM. 
Total system cost, including several boxes of 
blank cassettes, is under $100. 

3. Tape is a reliable storage medium, where 
good materials are used and care is taken. In 
a properly aligned system using low-noise, 
high-output cassettes, my own tests showed 
an average of one loading failure in 2.5 
million bits. 



4. Higher speed tape loaders add to the cost 
of the tape electronics, reducing their 
attractiveness, but increasing their speed 
and often their reliability where marginally 
recorded tapes are present. 

5. Tape storage is sequential access, except 
where special digital tape systems are used. 
A program, once in the process of being 
loaded, is not tried again and again should a 
bit failure occur. Data storage problems are 
compounded, with double-dumping almost a 
requirement, and sequential conception and 
operation of programs essential. 

6. The tape operating system is an essential 
part of the language, except where outboard 
devices (such as Fastload and similar 
systems) are used. Thus, it cannot be 
changed without adding a non-transparent, 
RAM-resident patch to the operating 
system. 

7. Disk systems are capable of fast transfer 
rates (125,000 bite per second is possible), 
but the orientation towards records, 
directories, and other internal checking and 
referencing systems creates an effective 
transfer rate of 10,000 bits per second or less. 

8. Disk systems contain built-in error 
checking and re-try routines. Thus, 
although data transfer errors occur as 
frequently as errors on cassette tape (if not 
more so), the random-access and retry 
capabilities make them appear error free 
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except where disks have been physically 
damaged, written over in error, or 
demagnetized. The apparent reliability is 
very high. 

9. Disk systems are comparatively costly in 
their original hardware configuration, their 
operating systems, and their medium. 
However, the storage cost of the medium is 
comparable to that of cassette tape, at about 
2/1000 of a cent per bit. The initial 
hardware investment is higher, requiring 
disk control ($300 for an expansion box or 
similar controller) and the drive ($350 or 
more, with quality increasing with price), 
and an operating system ($25 to $250, again 
depending on needs). An initial investment 
in disk storage, including a box of disks, can 
begin at $750 and end in the multiple 
thousands. 

10. System flexibility is increased greatly, as 
the disk's operating system and BASIC 
language additions overlay each other as 
needed, and appear almost transparent to 
system operation. However, the plethora of 
disk operating systems and approaches 
limits the interchangeability of information 
from one TRS-80 to another with a different 
operating system. 

11. Intermediate and hybrid systems are 
available that encompass some of the 
features of both standard tapes and disks. 
Foremost among these is the Exatron 
Stringy-Floppy endless-loop tape cartridge 
system. Its operating system is 
ROM-resident, its transfer rate is 7,200 bits 
per second. 

12. The Stringy-Floppy is probably the most 
reliable mass storage system under adverse 
environmental conditions, putting it above 
tape and far beyond the sensitive (some say 
temperamental) disk systems. This aspect 
more than any other probably justifies its 
consideration as serious mass storage. Based 
on hi-tech, laboratory models, the ESF is a 
scaled-down scientific storage system. 

13. Like tape, access using the ESF is 
sequential, but the endless loop makes 
pseudo-random access possible. With short 
tapes and programs less than 8K bytes, 
actual load/save time is faster than disk. 

14. Cost of this system is less than disk 
($250 for the hardware, $3 for the medium, 



an endless-loop 'wafer'), and the cost of 
storage is less than all other complete 
systems (about 1/1000 of a cent per bit). To 
be competitive with dropping disk prices, I 
expect to see the hardware cost drop. 

15. Although less fragile than disks (and 
higher in quality of the magnetic surface), 
the ESF wafers, because they use thin tape 
on a tiny, endless-loop hub, can be damaged 
by the tape binding or pulling from the 

housing. Unlike the larger cassettes, the 
tape cannot be successfully reinstalled in the 
housing, and unlike disks, the undamaged 
material on the wafer cannot be recovered. 

This chapter will present a tour through the 
available mass storage systems (except tape - see 
Supplements to Chapters 3(?) and 6(?)), describe 
the construction of a paper tape reader, and 
present the construction and operation of a tape 
storage device using 8-track cartridges. 

Disk Drives 

Disk drives come in a variety of sizes, shapes 
and formats. Among those are floppy disks in 
5-inch and 8-inch sizes; removable and 
permanent hard disks; and permanently housed 
Winchester drives. Miscellaneous variants of all 
kinds are for sale or under development. 

The most popular system for the TRS-80 is the 
5-inch floppy disk system. The drive contains a 
platter which spins the magnetic disk inside its 
cardboard sleeve, a record/playback head to read 
the data, and a stepping motor to move the head 
from concentric track to track. The data is 
recorded using sharp digital pulses without any 
sort of audio recording considerations such as 
high-frequency bias. DC 'trim erase' is used to 
remove previously recorded data just ahead of 
the write head. 

A single indexing hole near the center hub is 

used to inform the drive electronics and control 
software of the disk's position inside the paper 
sleeve. Other than this hole and a write-protect 
notch in the top edge of the paper case, there is no 
other information available to the drive and 
control software from a blank disk. It must be 
formatted, which is the process of embedding 
magnetic information on the disk for later use by 
the disk operating system. 

The information needed for the original Radio 
Shack specifications included the magnetic 
outlining of 35 concentric tracks on the disk, and 
the separation of those 35 tracks into ten 
discontinuous bands each, called sectors. 
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DIRECTION OF ROTATION 



Figure 9-1. Disc and disk system format 

Details of the system by which information is 
recorded on the disk can be found in the 
TRSDOS 9 Disk BASIC Reference Manual, and 
TRS-80 Disk 9 Other Mysteries. In summary, 
the original Radio Shack specifications called for 
a disk containing 35 tracks of 10 sectors of 256 
bytes each, for a total of 83,060 available bytes 
(89,600 are actually recorded, but several 
thousand are reserved for directory and other 
information - again, see the references above for 
details). 

Drive manufacturers and software authors 
immediately began modifying the Radio Shack 
standards. 40, 77 and 80 tracks could be used, 
and nearly a dozen different disk operating 
systems (DOS) made their appearance: the 
original TRSDOS from Radio Shack (versions 
through 2.3 now issued); NEWDOS, an updated 
and corrected version of TRSDOS, sold by 
Apparat; NEWDOS/80, a complete re-write 
incompatible with the others; VTOS (now issued 
through versions 4.0), written by the original 
author of TRSDOS; MicroDOS and its successor 
OS/80, a stripped-down, efficient, minimal DOS 
which is growing larger and hence less attractive; 
DBLDOS, a Percom entry that operates its 
double-density (80-track) hardware option; 
DOSPLUS in single- and double-density 
versions, a wide-ranging program by Micro 
Systems Software; CP/M, supposedly a standard 
DOS for microcomputers, but available only in 
modified form for the TRS-80; and many special 
operating systems to load and run protected 
software. 

Choosing a disk operating system is outside the 
range of this book, to be sure. Incompatibilities 
ride rampant over the bytes of the TRS-80 
computer; the consistent, convenient, accessible 
Level II ROM gives way under disk control to the 



whims of software authors and entrepreneurs, 
good and bad. It might seem like I'm knocking 
DOSes; I'm not, because it's truly a customizer's 
dream. But a problem arises when trying to deal 
with customization: to begin with, a disk 
operating system is a kind of customization. 
Hence, it becomes almost impossible to 
customize one further without being forced to 
provide versions for every popular DOS. There 
are too many, and they change quickly ... to 
patch them invites problems, ill will, and 
frustration. 

On the other hand, a disk system is ideal for 
customizing the TRS-80, because, once you have 
selected the operating system, you may modify 
and change it, making it your own. In a sense, 
that is how Apparat created NEWDOS - as a 
series of patches and improvements to TRSDOS, 
and in fact it originally required that disk users 
already own a copy of TRSDOS. 

Inside A Disk Drive 

The insides of a disk drive seem incredibly 
simple. In fact, they are. It is only the precision 
of alignment needed and a few expensive parts 
which bring the cost so high. The drive consists 
of an electronic control board which is capable of 
communicating with the controlling computer, in 
this case the TRS-80, through a disk controller 
chip (FDC - see below). There is a motor which 
spins the disk, and in most inexpensive drives 
this motor is connected through a drive belt to 
the disk hub. The motor speed of 300 rpm must 
be accurate to within five percent; three percent 
deviation from normal is reasonable, and most 
drives are capable of a 1.5 percent long-term 
deviation. The disk is inserted in the housing and 
held in place by a cone and pressure plate which 
fit around the hub, and clamp gently but firmly 
to the disk's center area. 

When the door to the drive is closed, the 
pressure plate moves into place, and the disk is 
brought into contact with the read/write head. A 
properly seated disk will present the indexing 
opening to a light sensor, so that as it spins inside 
the paper envelope, the index hole will open the 
light beam as it passes by. 

A stepping motor is capable of moving 
precisely to one position on its axis, on command. 
This type of motor is used to position a magnetic 
read/write head on the disk track to be read. The 
motor is fast and precise, and the assembly which 
it moves is carefully machined so there is 
virtually no up-down play in the head. Opposite 
the head is a pressure pad which forces the disk 
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to maintain contact with the head, albeit 
separated from the head by a few microinches. 

The head itself is usually of the glass-ferrite 
variety; it has an extremely smooth, highly 
polished surface that will not damage the disk, 
and a very long life that exceeds 20,000 hours of 
continuous head-to-disk contact. It is capable of 
handling the high write currents generated by 
the digital circuitry, and virtually immune to 
electronic noise in its vicinity. 

In the TRS-80 system, the disk drive itself 
accepts and sends certain pieces of information. 
They are: 

1. A 4-bit drive select indicator sent to the 
drive; only the drive hard-wired to accept 
this signal will respond. In the TRS-80 
system, this wiring is done in the cable itself. 

2. A motor-on signal, which turns on the 300 
rpm hub motor. 

3. A track-to-track stepping signal and a 
stepping direction signal. 

4. A write-enable signal and a stream of 
written data. 



5. A stream of written data sent by the 
drive. 

6. A write-protect signal to prevent writing 
to write-protected disks. Most drives will 
not respond to a write signal, and this 
write-protect signal is sent so the software 
can report a write-protected condition. 

7. An index pulse to indicate where the disk 
is currently located in its rotation. 

8. A track-zero indicator to identify when 
the disk head has reached the outermost 
track on the disk. This is used to locate 
tracks, relocate tracks or reposition the head, 
and on initial access to identify the head 
position. 

Except for the drive-select signals, the disk 
controller chip is responsible for managing all 
these lines. In the TRS-80, a type 1771 controller 
is used, manufactured by Western Digital. A 
complete data sheet is provided with the 
Expansion Interface service manual from Radio 
Shack. 
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This controller has eight data input/output 
lines (DALO to DAL7) to the computer, an 
interrupt output to signal its need for service 
(INTRQ), read and write enables (RE and WE), 
and a two-bit address select (AO and Al). These 
last are used to select the register that will send or 
receive data on the DAL lines: 



RE 



ME 



Statue Register 
Treck Register 
Sector Register 
Deta Register 



Command Register 
Track Register 
Sector Register 
Date Register 



•**•******•»*»»*»•»**************»*****»*•*********»*** 




Photo 9-1. Pictorial tour (6) of disk drive. 

Front door of disk drive controls mechanism to steady the disk as 

ire// as a switch to indicate that the door is closed 



In the TRS-80, the chip is always selected (CS) 
because the buffering of data is taken care of by 
Z33, Z37 and Z38 in the expansion box. The Data 
Request signal (DRQ) is not used, nor are the 
three-phase motor signals (PH3 and 3PM), and 
the track-greater-than-43 signal (TG43). These 
signals would be present were a more 
sophisticated disk drive capability intended by 
Radio Shack in future versions of the TRS-80. 

The clock input is provided by the separate 
oscillator in the expansion interface. Three 
voltages are needed (+12, +5, and -5), plus 
ground. 

Test, disk initialization (DINT), and 
write-fault lines (WF) are not used, nor are the 
infamous external data separation (XTDS) and 
external data clock (FD CLOCK) lines. Disk 
data are separated by clock pulses, and high 
accuracy demands unfailing differentiation 
between the clock pulses and the data pulses. 
The Percom data separator plugs into the 
controller chip socket and makes use of XTDS 
and FD CLOCK. 

The head-load output (which determines 
whether the read/write head is in place against 
the disk) is not used, because software controls 
the timing between motion of the read-write 
head. Head-load timing (HLT) and READY are 
both connected via external logic to the TRS-80, 
where software determines when the drive and 
read/write head should be ready to read or write. 
The remaining disk controller signals lead to and 
from the disk drive itself, and are identical to 
those listed in the description of the drive signals. 




Circuit card contains disk read/write circuitry, motor stepping 
control, and computer interfacing. Computer connector and 
termination resistors are seen at lower right 



Opposite side from control card is the drive motor with speed 
strobe disk, and a window revealing the shaft of the head 
stepping motor. 
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Close-up of read/write head and pressure pad. White square is 
glass ferrite head surface, vertical stripe is the head's read/write 
surface. Pressure pad moves into place when the disc's front door 
is closed 



Removing the control circuit card reveals a heavy cast frame to 
hold the disk in place. In center is the cone that fits through the 
disk; to the right is a pressure pad 





Close- up of positioning sensor. Index hole of a disk allows light to 
pass from LED emitter to sensor (top center). 



The drive with a disk in place. Cone fits through disk and clamps 
it in place. Head and index hole light emitter are on the other side 
of the disc; pressure pad and light sensor are on this side. 




Hefty disk drive power supply handles motor drive current and 
powers the electronics. 
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A Heavy Dose of DOSes 

On the software side, the number of disk 
operating systems for the Model I continues to 
increase. Most include 'Level III BASIC, the 
usual copying and formatting capabilities, but 
have been expanded to include more than that. 
For a complete description of the features of 
competing DOSes, refer to the March 1981 
issue of 80 Microcomputing. Among the special 
features of the most prominent DOSes: 

TRSDOS. AUTO, ATTRIB, CLOCK, 
COPY, DATE, DEVICE, DIR, DUMP, KILL, 
FREE, LIB, LIST, LOAD, PRINT, PROT, 
RENAME, TIME, VERIFY. Also BASIC, 
BASIC2, DEBUG, TRACE. Level III BASIC 
functions. Details are found in the TRSDOS 



manual, and other DOSes include all of these 
commands in some way or other. 



A Garden Full of Varieties 

The available variety of disk drives is 
growing. Not only are the capabilities of 
standard 5-inch drives being stretched (to run 
40, 77 and 80 track densities), but 8-inch 
systems and hard-disk systems are being 
introduced for the lowly TRS-80. Among them: 

Manufacturer Model/Type Price Comments 



Minifloppy (5-inch) Disc Systems 



AFD-100 $315 40 trecke; Tendon? 

40-1 (350 40 tracks; doub La-density 

80-1 $460 80 trecks; double-density 

80-2 $460 40 trecks; doub Le-si ded; 

double density. 
160-2 (600 80 trecks; double-sided; 

double density. 

CCI-100 *315 40 tracks; Percom? 
CCI-200 1430 80 tracks; Percom? 

B/51 $320 40 tracke; 5 me treck 

-to-treck; euto-eject; 

double-density haad. 
B/91 $425 80 tracks; 3 ms treck 

-to-track; euto-eject; 

double-density head. 

35 trecks, single heed 
35 tracks, dual head 
77 tracks, single heed 

77 trBCks, dueL heed 



Aerocomp 
CPU Shop 

MP I 

Micro polls 

Percom 

Pertec 
Shugart 

Siemens 

Tandon 

TEAC 

Vista 



HCP1027 $300 
MCP1037 $700 
MCP1 027-2 $440 
MCP1 037-2 $800 



TFD-100 
TFD-200 

FD200 

SA-400 
SA-410 



$350+ 40 tracks 
$650+ 77 tracka 



$380 



$330 
$340 



FDD 100-5 $275 
$... 



$300 
$400 



V-80 $400 

V-800 $600 

V-B800 $775 



40 trecks 

35 trecks 
40 tracks 

40 tracks, double density 

40 trecks 

40 tracks 

80 tracks 

40 tracks 
80 tracks 
160 tracks 



NEWDOS+. Adds COPY, JKL screen 
print, DIRCHECK directory verification, 
LMOFFSET tape load offset module, 
EDTASM with modifications, SUPERZAP 
for modifying disk contents, LEVEL 1 located 
in RAM, DISASSEM, LV1DSKSL disk 
save/load for Level I. CMD"DOS 
COMMAND NAME" to execute from BASIC, 
and several commands to re-enter BASIC 
from DOS. 

NEWDOS/80. CHAIN, HIMEM 
protection from DOS, JKL, MINIDOS 
don't-distrub-memory DOS, MDBORT for 
killing MINIDOS, PDRIVE setup for 
multiple drive types, PURGE for killing file 
groups, SYSTEM to create special commands, 
SUPERZAP, LMOFFSET, LEVEL 1, 
ASPOOL print spooler, DIRCHECK. 

VTOS. BOOT software reset, BUILD a 
group of auto-excute programs, CHAIN to 
execute them, MEMORY, PURGE, RUN for 
non-VTOS systems, SYSTEM , XFER disk 
copy program, PATCH disk modification 
routine, VTCOMM communications utility, 
KSR terminal program, ROUTE for changing 
the destination of data, SET for a user device 
program, SPOOL, RESET to cancel device 
setup, LINK for devices, FILTER to be used 
with device routing, ALLOC setting up disk 
space in advance. 

DOSPLUS. Adds BOOT, BUILD, CLEAR 
a directory file, DO group of auto-exeute 
programs, FORMS to set up the printer driver 
, a different variant of FREE, PAUSE for user 
input in auto-execute routines, RS232 for a 
report on that status, PURGE, DISKZAP for 
modifying disk information, CLRFILE for 
zeroing a file, COPY1 copying utility, 
CRUNCH space compression for BASIC, 
TRANSFER program copier. 

ULTRADOS. CLEAR for zeroing 
memory, DEAD for zeroing memory, 
TOPMEM for setting DOS-protected 
memory, CMD"C" compression routine, 
CMD'DOS COMMAND NAME" which 
executes from BASIC, CMD"0" file buffer 
allocation, CMD"X" to return to BASIC from 
DOS, cross referenced listing of variables and 
line numbers, renumbering from BASIC, 
shorthand command keystrokes. 
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The Exatron Stringy-Floppy 

In between tape systems and disk systems is an 
unusual device. I only say 'in between' because 
the name Stringy-Floppy implies that it 
somehow is a tapelike version of a floppy disk 
device. In fact, it is not, for two major reasons: it 
is a unique, high reliability, high endurance 
storage medium; and it does not (at least in its 
TRS-80 configuration) contain formatting, 
sectoring, or record-keeping of the type used for 
disks. 

The Exatron Stringy-Floppy (ESF) consists 
of a small DC motor which uses a tiny plastic belt 
to drive a capstan, exactly as in a cassette player. 
The motor's speed, however, is set to 10.5 inches 
per second, quite a bit faster than cassette, 
8-track, or even open-reel. Thus, even though 
the tape itself is only 1/16 of an inch wide, 
reasonable data recording can be expected. 

In the TRS-80 version, the ESF does not use 
any standard method of recording. A separate 
sequence is used to prepare, or 'verify' an 
endless-loop tape wafer than that which is used 
to record data. Both methods use a variety of 
bi-phase recording, in which the bit being read or 
recorded depends on the polarity of the bit just 
written or read. 




This makes the ESF reliable in spite of a motor 
speed which varies more than ten percent in 
either direction of its ideal speed. It also means 
the ESF can work under harsh conditions which 
might otherwise throw a standard clock/data 
system far off. 

Programs are recorded on the ESF in a 
continuous stream, preceded by a leader and 
followed by information to assist the software in 
locating the next available blank program space. 
Programs and data may be read in any order, but 
must be written in ascending numerical order. 

The ESF operating system is contained in a 
read only memory which resides in the 
unassigned memory area on the Model I (3000 to 
37C0); thus, it is always available and relatively 
crash-free. It does use a few bytes of RAM, 
however, and must also patch into the Level II 
BASIC parameters in low memory. 

The wafer itself is available only from 
Exatron, and is based on the wafers used in 
industrial applications. It consists of a length of 
high-output digital recording tape, highly 
polished. This is wound on a small hub, 
lubricated, and spliced into an endless-loop. A 
reflective splice is used to determine end-of-tape 
(EOT/BOT), and is viewed through a window at 
the top of the wafer. 

The wafers may be write-protected by affixing 
a reflective-tape dot on the wafer. This is read by 
the operating system before the drive is 
activated. The ESF operating system consists of 
these commands: 

©LOADx Load a program; x is the program 
number, and is optional. An error in the load 



Photo 9-2. Pictorial tour (6) of ESF system. 



Exatron Stringy-Floppy placed next to Microconnection modem. 
Both are compact, light devices. 




ESF 'rubber band' drive is not as reliable as disk drives, but 
software is capable of handling greater variations in speed 
Small DC motor replaced by a direct-drive type in later versions, 
say Exatron officials. 



210 



Chapter 9 



Fastload, TC-8, and Other Systems 



terminates the process and the error (parity or 
checksum) is reported to the user. 

©SAVEx Saves a BASIC program; the x is 
the program number, and is required. The 
program is verified, and any saving errors are 
reported. 

@SAVEx,r,s,t Saves a block of memory; x is 
the program number, r is the starting address, 
and s is the length of the block. These are 
required. The t is an optional entry address. 
All numbers are in decimal. The block is 
verified, and any saving errors are reported. 

@NEWx Verifies a wafer. When x is used, 
the wafer is cleared and verified from that 
program to the end splice. Available byte 
count is reported. 

Fastload, TC-8, and Other Systems 

Most other alternatives to disk systems involve 
using standard cassettes for high-speed saving 
and loading. Among these are Fastload, 
manufactured by Personal Microcomputers, 
Inc.; TC-8, or the 'Poor Man's Floppy', made by 
JPC Systems; and the Beta-80, made by Meca 
Technology. 

The advantage to the standard cassette is 
simple: cost and availability. Unlike disks, they 
are able to take some measure of abuse, and can 
be replaced without regret over the expense. And 




Control card ofESF contains drive electronics, tape read/write 
circuitry, and 2716 EPROM containing the ESF operating 
system. Power supply is underneath the card 



unlike Exatron wafers (or disks, for that matter), 
they can be purchased if necessary in the local 
grocery. Furthermore, cassette tape technology 
has progressed further than disk technology, 
providing better surfaces, adhesion, and 
signal-to-noise ratio. Disks are still in the dark 
ages of reproduction compared to audio tape. 

Fastload is a ROM-based operating system 
combined with a hardware detection and shaping 
circuit. A modified CTR-41 is used, where the 
fast-forward button and play button can be 
locked down. The circuit then can read a 
standard 500-baud tape in the fast-forward mode 
quite reliably at about 8000 baud. Debounce, 
audible beep, and key repeat are included with 
the operating system. 

Although I have not examined the schematics 
for Fastload, its carefully designed circuit board, 
with voltage regulator heat-sinked to the case, 
attest to a cautious, probably over-designed 
system. The loading system is put into operation 
by typing SYSTEM (ENTER), /12288 
(ENTER); optional debounce/beep/repeat can 
be added as well. 

When in operation, Fastload uses the single 
LOAD command in Level II, and is compatible 
with disk-based computers by using a SYSTEM 
call. The 500-baud load and save are left 
undisturbed. Fastload is well-designed, and 
reasonably reliable. If your original tapes have 
audible 'bumps' when played at high speed, 
however, they may not load easily with this 
system. Commercial tapes, or those recorded by 
the user on virgin cassettes, load easily and 
extremely fast. 'Bumpy' tapes, however, do not 
load well, and have to be re-recorded. 

One of the other disturbing features of 
Fastload is its tendency to give a 'READY' 
message even when a BASIC program has been 
loaded incorrectly. Granted, it is almost 
impossible to be sure a BASIC program has 
loaded well because, in its normal CSAVE 
format, no checksums have been provided. But 
the user should be sure to list the program before 
expecting it to run. SYSTEM loads, on the other 
hand, present checksum error messages on bad 
loads. Fastload costs $188 assembled; a modified 
CTR-41 is $95. 

TC-8, or the Poor Man's Floppy, both saves 
and records at high speed. It is provided in kit 
form; assembly can be completed in a few hours. 
Like Fastload, the TC-8 plugs into the edge 
connector, but the software is RAM-resident. 
The standard CTR-80 tape recorder is used, and 
a two-wire swap is shown to make the CTR-41 
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Photo 9-3. Fastload device. 



Instead of a smalt heat sink, Fastload power supply regulator is 
sinked to the entire metal case. Insulators around regulator 
show attention to detail. 




Photo 9-4. Fastload circuit card 



Circuit card for Fastload shows extremely conservative design, 
with careful attention to grounding and possible noise sources. 
DIP resistor package is used in place of separate resistors, and 
the operating system is contained in a 2716 EPROM. Since less 
than IK of the EPROM is used for the operating system, the 
remainder may be programmed by the user with utilities. 



run properly (its high current tended to fuse 
motor relays together on the TRS-80). 

Since it is both a record and save device, the 
TC-8 contains fifteen separate commands, 
including SAVE (BASIC programs only) and 
PUT (machine language blocks); LOAD BASIC 
programs next or by name; LOAD? for 
verification; LOADN to position the tape; 
comparable GET commands for machine 
language programs; RUN as a load-and-go 
command; RSET for cassette motor on; OPEN, 
CLOSE, PRINT, and INPUT for file 
management; and KILL to eliminate file 
management. 

The software can be reconfigured, relocated, 
and stripped to a memory-saving bootstrap 
version. The TC-8 is provided with extensive 
documentation which is clear and literate, 
providing examples, a sample program using the 
OPEN, PRINT#, INPUT#, and CLOSE 
commands, along with recommendations, 
suggestions, and warnings (plus sympathy!) 
about the problems of transferring some 
commercial machine-language software to the 
TC-8. 

The circuit is quite simple, but well designed 
and accurate; the capabilities of this elegant 
circuit comes from the software. The 
construction manual provides soldering 
suggestions and explanations, recommendations 
on the soldering iron to purchase, and drawings 
of properly soldered connections. For 
convenience, all work is done on the underside of 
the board; correct placement and orientation of 
parts is emphasized. Two-color layouts of the 
board are provided on every page, along with a 
checklist of each step. These are some of the 
finest assembly instructions I have seen for a 
project. 

When complete, the unit loads and saves at 
2500 baud on off-the-shelf cassettes. The 
company recommends certain brands, and also 
sells the brand JPC products uses. All signals to 
the tape player are non-critical, and the loading 
routine will accept signals over most of the 
audible, undistorted output spectrum of most 
cassette recorders. TC-8 costs $90 in kit form. 

The Beta-80 is a tape storage system patterned 
after professional digital tape devices. Although 
a standard digital cassette is used, the Beta-80 is 
configured something like a disk, with directory 
and fast access. Fast forward and rewind are 
automatically controlled by the RAM-resident 
operating system, and the search speed is 100 
inches per second. 
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Photo 9-5. TC-8 tape system. 

TC-8 tape system attaches to edge-card connector and cassette 
recorder to provide high-speed record/save of programs. Photo 
courtesy JPC Products Company. 



7000 0608 

7002 C5 

7003 0620 
7005 10FE 
7007 C1 
700B CD1470 
700B CB11 
700D 17 
700E CD3670 
7011 10F5 
7013 C9 



7014 
7015 
7010 
701A 
7D1C 
701E 
7020 
7022 
7024 
7 26 
7028 
702A 
702C 
702E 



cs 

3A3D40 

E6FC 

F601 

D3FF 

0607 

10FE 

E6FC 

F602 

D3FF 

0607 

10FE 

E6FC 

D3FF 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00 240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
00460 
470 
00480 
00490 
00500 
00510 
00520 
00530 
00540 
00550 
0056 
570 



ttmmmim 

HIGH SPEED TAPE 
BAUD. THIS CAN 
EITHER /SAVE AN 
PRESENTED HERE 
BE USED FOR SAV 
AND END OF THE 
END OF BASIC ME 
ARE PRESENTED A 

n t, milium 

ORG 7 



m mmmmmmmmmmmmi 

LOAD AND SAVE ROUTINE OPERATING AT 1960 
BE MADE TRANSPARENT TO BASIC BY USING 
D /LDAD OR /PUT AND /GET. THE ROUTINE 
SAVES A BLOCK OF MACHINE CODE, BUT MAY 
ING AND LOADING BASIC BY LOCATING START 
BASIC PROGRAM (FOR WRITE], AND START AND 
MORY (FOR READ). SAMPLE ACCESS ROUTINES 
T THE END OF THIS LISTING. 

mmtmmmttmmiitmmtmm 

DOOH ; TOP OF MEMORY - RELOC. 



PUSH 


BC 


LD 


B, 20H 


OJNZ 


t 


POP 


BC 


CALL 


TIMEX 


RL 


C 


RLA 




CALL 


BITEX 


DJNZ 


WLOOP 


RET 





iimmimmmmmmmmmmmmmimm 

WRITE-BYTE SUBROUTINE. BYTE IS ASSUMED IN C REGISTER 

tummiititmitntmiHHtmutmiHimmmtt 



NUMBER OF BITS TO WRITE 
SAVE BITS OF BYTE 
GET A DELAY VALUE 
AND DELAY 117 USECS 
AND RESTORE BITS 
WRITE TIMING BIT 
ROTATE BIT INTO FLAG 
ROTATE FLAG INTO A 
WRITE BIT TO TAPE 
DO IT TOTAL OF 8 TIMES 
BACK FROM WRITE ROUTINE 



a mmm iii mm mmmummmmmmmm 

ROUTINE TO WRITE TIMING BIT POSITIVE-NEGATIVE TO TAPE 

tuttummmmmmtmittHimtHtntHttmim 



SAVE B ON STACK 
GET SCREEN INFORMATION 
MASK OUT LOW TWO BITS 
SET LOWEST BIT 
WRITE BIT TO TAPE 
TIMING VALUE 6 1 .77 MHZ 
IS EQUAL TO 67 USECS 
MASK OUT LOW TWO BITS 
SET NEXT LOWEST BIT 
WRITE NEG. BIT TO TAPE 
TIMING VALUE 6 1 .77 MHZ 
IS EQUAL TO 64 USECS 
MASK OUT LOW TWO BITS 
WRITE NEUTRAL BIT 



PUSH 


BC 


LD 


A, i 403 DH) 


AND 


OFCH 


OR 


1 


OUT 


10FFH) ,A 


LD 


B,07H 


DJNZ 


1 


AND 


OFCH 


OP 


2 


OUT 


IGFFH) ,A 


LD 


B.07H 


DJNZ 


• 


AND 


OFCH 


OUT 


(OFFHJ ,A 



Listing 9-2. High-speed tape loading routine. 



Loading is at 4000 baud (tape running at 5 
i.p.s.), twice the speed of the TC-8, but about half 
that of the Exatron Stringy-Floppy and 
Fastload, but access time (using the directory) is 
less than a minute for more than a half megabyte 
of stored programs. 

Commands are LOAD in the form of load, load 
and run, and load array information; SAVE for 
programs and arrays; MERGE for append (not a 
true merge) or append and run; and KILL to 
delete a program or an array. Other commands 
operate within the various RAM-resident 
systems. 

The Beta-80 uses a reliable Phi-deck drive, 
and has impressive features. However, as of this 
writing, users report little support from Meca for 
converting and saving machine language 
programs on the Beta-80. The Beta-80 costs 
under $300. 



High-Speed Cassette Loading 

Speeds higher than 500 baud are achievable 
entirely through software, and most systems 
work exceedingly well. Among the most popular 
are: SPEED, the first such program, loading and 
saving at 1500 (?) baud; HISPED (Palomar 
Software, 170 S. Palomar Dr.. Redwood City, CA 
94062; $24.95), a 2000-baud system; ZIPLOAD, 
in the public domain and published in the 80 
Encyclopedia (Wayne Green, Inc.); and B-17 
(ABS Suppliers, P.O. Box 8297, Ann Arbor, MI 
48107; $25). 

Each of these save/load programs patches into 
the BASIC operating system, and all use the 
DOS-reserved LOAD and SAVE commands. 
The last is of particular interest because it is a 
complete system rather than merely a save/load 
program. 

SAVE, using a six-character name, sends 
BASIC programs to tape; LOAD? verifies them. 
LOAD puts the computer into the SYSTEM 
mode automatically and loads a BASIC program. 
PUT and GET are used for formatted file arrays. 
It is also provided with a machine language 
module. Checksum errors, full memory buffer, 
continuity errors, and format errors are reported 
by this module. The entire source code is 
available for sale if the B-17 program is also 
purchased. 

Aside from B-17's high reliability, it also 
provides an on-screen prompt indicating saving 
and loading. 

What makes a high-speed loader not only 



The Custom TRS-80 
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A Paper Tape Reader 



7030 0607 
7038 10FE 

7034 CI 

7035 C9 



7036 
7037 
7039 
703A 
703D 
703F 
7040 
7042 
7043 
7045 
7047 
7048 
704A 
704C 
704D 
704F 
7060 
7062 
7054 
7056 
7058 
705A 
705C 
705D 
705E 



705F 
7060 
7063 
706B 
7069 
706A 
706C 
706F 
7071 
7073 
7074 
7076 
7078 
707B 



C5 

E601 

47 

3A3040 

E6FC 

60 

D3FF 

C5 

0606 

10FE 

C1 

CBOO 

E6FC 

90 

D3FF 

C5 

0606 

10FE 

E6FC 

D3FF 

0608 

10FE 

CI 

C1 

C9 



AF 

C01202 

010000 

CD6000 

C5 

DEOO 

CD0070 

0608 

10FE 

C1 

10F3 

0EA5 

CD0070 

C9 



707C 0609 
707E C08A70 
7081 C09C70 

7084 17 

7085 CB11 
7097 10F5 
7088 C9 



708A CDC770 
7080 OBFF 
70BF 17 
7090 30FB 

7092 C5 

7093 OEOF 
7095 10FE 

7097 C 

7098 CDC770 
7098 C9 



709C CS 
7090 0619 
709F 10FE 
70A1 DBFF 
70A3 C1 
70A4 C9 



70A5 AF 
7DA6 CD1202 
70A9 CD6A70 
70AC CD9C70 
70AF 17 
7090 30F3 



00580 
00590 
00600 
00610 
D0620 
00630 
00640 
00660 
00860 
00670 
00680 
00680 
00700 
00710 
00720 
007 30 
07 40 
00750 
00760 
00770 
007 80 
007 90 
00800 
00810 
00820 
00830 
00840 
00850 
00860 
00870 
00880 
00890 
00900 
00910 
00920 
00930 
00840 
00950 
00960 
00970 
00880 
00990 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
01170 
01180 
01190 
01200 
01210 
01220 
01230 
01240 
01250 
01260 
01270 
01280 
O12S0 
01300 
01310 
01320 
01330 
01340 
01350 
01360 
01370 
01380 
01390 
01400 
U1410 
01420 
0143 
01440 
01450 
01460 
01470 
D1480 
01490 
01500 
01510 
01520 
0153 
01540 
01550 
01560 
01570 
01580 
01590 



LD 


B.07H 


DJNZ 


1 


POP 


BC 


RET 





TIMING VALUE • 1 .77 MHZ 
IS EQUAL TO 113 USECS 
RESTORE NUMBER OF BITS 
BACK TO BIT WRITE ROUT. 



tt immmmmummmummmmmumitit 

ROUTINE TO WRITE INDIVIDUAL BIT TO TAPE (OR NOT IF OJ 

iiiiiiiiiiiimiiiiiittitititititititiiimiiiiitiiiin 



SAVE NUMBER OF BITS 
MASK OUT ALL BUT BIT 
SAVE A IN B REGISTER 
GET SCREEN STATUS 
MASK OUT LOW TWO BITS 
SET BIT OR NOT 
SEND OUT CASSETTE PORT 
SAVE B REGISTER AGAIN 
TIMING VALUE FOR BIT 
DELAY IS 65 USECS 
GET VALUE BACK INTO B 
ROTATE INTO BIT 1 
MASK OUT LOW BITS AGAIN 
SET BIT 1 OR NOT 
SEND OUT CASSETTE PORT 
SAVE B REGISTER AGAIN 
DELAY IS 63 USECS 
DELAY FOR BOTTOM OF BIT 
CREATE A NEUTRAL BIT 
AND WRITE IT TO TAPE 
GET DELAY VALUE IN B 
DELAY IS 110 USECS 
CLEAR STACK OF BIT 
GET ORIGINAL BITS BACK 
BACK TO SAVING ROUTINE 



ti tun it tin limit in i mill ii ii iii i it it ii imni it 1 1 

ROUTINE TO WRITE LEADER OF 256 BYTES OF FF PLUS SYNC A5 

ittimimtiimmimtmtmiimiiimmmiimi 



PUSH 


BC 


AND 


1 


LD 


B,A 


LD 


A, I 403DH] 


AND 


OFCH 


ADD 


A, 8 


OUT 


10FFH) ,A 


PUSH 


BC 


LD 


B.05H 


OJNZ 


( 


POP 


BC 


RLC 


B 


AND 


OFCH 


ADD 


A,B 


OUT 


I0FFH) ,A 


PUSH 


BC 


LD 


B.06H 


DJNZ 


( 


AND 


OFCH 


OUT 


(OFFH) ,A 


LO 


B.OBH 


DJNZ 


t 


POP 


BC 


POP 


BC 


RET 





XOR 

CALL 

LD 

CALL 

PUSH 

LD 

CALL 

LO 

DJNZ 

POP 

DJNZ 

LD 

CALL 

RET 



A 

021 2H 

BC,0 

0060H 

BC 

C,D 

WRITE 

9,9 

S 

BC 

SYLOOP 

C.0A5H 

WRITE 



DEFINE DRIVE NUMBER 
DRIVE MOTOR RUNNING 
NEED A LOOP ABOUT 1 SEC 
CALL DELAY IN ROM 
SAVE THIS VALUE (BC=0) 
WRITE BYTE OF 1111 1111 
WRITE THAT BYTE 
SHORT LOOP BETW. BYTES 
DELAY JUST 5B USECS 
RESTORE VALUE FOR USE 
WRITE TOTAL OF FF BYTES 
SYNCHRONIZATION BYTE 
WRITE THAT BYTE 
BACK TO MAIN ROUTINE 



iittiimiimiiiimtiittimtmtimiimimiiiim 

READ BYTE SUBROUTINE: COMPLETED BYTE INTO C REGISTER 

ttmmtmimmmmmmmmttimmmmm 



READ 
RLOOP 



LD 

CALL 

CALL 

RLA 

RL 

DJNZ 

RET 



REDEX 
REOBIT 



C 

RLOOP 



NUMBER OF BITS TO READ 
READ TIMING BIT 
READ DATA BIT IF ANY 
ROTATE BIT INTO CARRY 
ROTATE CARRY INTO C 
DO IT TOTAL OF 8 TIMES 
BACK FROM REAO ROUTINE 



it ttmmtiimumim mm mmt mint i tt mint 

ROUTINE TO READ TIMING BIT FROM TAPE AND DELAY AFTER 

iiimmmimmmmtmimitmtmmmmmi 



REOEX 
REDX2 



CALL 

IN 

RLA 

JR 

PUSH 

LD 

DJNZ 

POP 

CALL 

RET 



INSIG 
A, (OFFH) 

NC,REDX2 

BC 

B.OFH 

S 

BC 

INSIG 



KEEP LOOKING FOR ONE 
KEEP LOOKING FOR ONE 
ROTATE INTO CARRY 
KEEP LOOKING FOR ONE 
SAVE NUMBER OF BITS 
VALUE TO DELAY 
AND DELAY FOR 144 USECS 
RESTORE NUMBER OF BITS 
RESET INSIG FLIP-FLOP 
BACK TO MAIN ROUTINE 



ti m mm ii m ii m mmmtim it m m mm m m 

ROUTINE TO READ INDIVIDUAL DATA BIT IIF ANY] FROM TAPE 

ti mmti immmm i m mi mmm i mi ii ii ii i m 



PUSH 

LD 

DJNZ 

IN 

POP 

RET 



BC 

B.18H 

t 

A, (OFFH) 
BC 



SAVE VALUE IN B AND C 
VALUE FOR DELAY 
EQUAL TO 197 USECS 
GET VALUE FROM CASSETTE 
RESTORE VALUES TO B & C 
RETURN WITH VALUE IN A 



; ii immmmmmmm mini mmmmmmm 

; THIS ROUTINE HEADS THROUGH THE LEADER FDR SYNC BYTE 

; mtumuummmmttuummimu timtmttt 



XOR 

CALL 

CALL 

CALL 

RLA 

JR 



A 

21 2H 

REDEX 

REDBIT 

NC.REDSYN 



DEFINE DRIVE NUMBER D 
DRIVE IS RUNNING 
READ TIMING BIT 
GET €IT FRDM TAPE 
ROTATE INTO CARRY FLAG 
KEEP LOOKING FOR A 1 



possible, but reliable, especially since the 
TRS-80's 500-baud rate seems to be full of flaws? 
As noted in the Supplement to Chapter 6 (?), the 
500-baud rate is actually fairly reliable, except 
that a few misconceptions on the part of the 
ROM designers led to incorrect load timing. The 
writers of the high speed loaders noted above 
took considerably more care in designing their 
input/output schemes, and thus achieved that 
reliability. 

Listing 9-2 presents a pair of high-speed 
input/output modules that load and save blocks 
of memory at 2000 (?) baud. These modules may 
supplant the CALLs to 0235 in all the 
input/output routines presented elsewhere in 
this book, allowing faster saving and loading of 
memory blocks, data, screens, etc. These 
routines use the normal cassette output. For a 
high-speed loader using an 8-track system and 
digital, very reliable recording, see Chapter 9. 

A Paper Tape Reader 

' One of the more common sights in the early 
days of larger computers was a bank of spinning 
tape reels for magnetic and punched tapes. Both 
still exist, but are not common storage modes for 
microcomputers like the TRS-80. 

However, you may have the chance to pick up 
some terrific programs written for an 8080-based 
computer, especially those in the National 
Semiconductor library. These include 
double-precision mathematical subroutines, text 
handlers, light-pen readers, etc., and are 
sometimes available at low prices. But they are 
stored on rolls of paper tape. Software for 
devices such as the Computalker Speech Lab is 
also provided on paper tape. 

Furthermore, though paper tape may no 
longer be the popular program storage medium it 
once was, for archival storage or communicating 
among different styles and types of computers, it 
still has its place. For occasional use, then, paper 
tape can be used, but an expensive reader won't 
be a very good investment. For less than $50, you 
can interface the TPR-1 paper tape reader and 
the TRS-80. 

The TPR-1 reader is sold by Raeco, Box 165, 
Washington, Maine 04574. The unit consists of a 
machined, brushed aluminum track for the paper 
tape, and a -circuit board attached to the track. 
On the board are two integrated circuits, and 
nine light sensors are on the board under holes in 
the track; also provided are an LED test light, 
resistors, and a 14-pin DIP socket. It is sold with 
a good technical manual for $32.50; an optional 
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A Paper Tape Reader 



70B2 


CB11 


01600 




HL 


C i 


ROTATE INTO C REGISTER 


70B4 


0607 


01610 




LD 


B,7 i 


NUMBER OF BITS LEFT 


70B6 


CD8A70 


01620 


SYNCLP 


CALL 


REDEX ; 


READ TIMING BIT 


70B9 


C09C70 


01630 




CALL 


REOBIT ; 


GET BIT FRDM TAPE 


70BC 


17 


01640 




RLA 




ROTATE INTO CARRY FLAG 


70BD 


CB11 


01650 




RL 


C ; 


ROTATE INTO C REGISTER 


70BF 


10F5 


01660 




DJNZ 


SYNCLP ; 


00 IT 7 TIMES LEFT 


70C1 


3EA5 


01670 




LD 


A.0A5H ; 


LOAD SYNC BYTE VALUE 


70C3 


BS 


016B0 




CP 


C i 


COMPARE AGAINST C 


7DC4 


OB 


01690 




RET 


Z ; 


RETURN IF A MATCH 


7DC5 


1BDE 


01700 
01710 




JR 


REDSYN ; 


BACK TO KEEP LOOKING 






01720 


': iiiuntiuiitiiiiniiintmuntutiituunitnittu 






01730 


; ROUTINE TO RESET INSIB FLIP-FLOP TO BE ABLE TO READ 






01740 


; >i mniuiiiiniitiiiiiiiiittiuimtitiitiniiiiiiiii 






017b0 


; 








70C7 


F5 


01760 


INSIG 


PUSH 


AF 


SAVE VALUE IN AF 


7QCB 


3A3D40 


01770 




LO 


A, I403DH) 


GET SCREEN STATUS BYTE 


70CB 


D3FF 


01780 




OUT 


(OFFH) ,A 


RESET FLIP-FLOP 


70CD 


F1 


01790 




POP 


AF 


RESTORE AF STATUS 


70CE 


C9 


01800 
01810 




RET 




BACK TO READING ROUTINE 






01B20 


! ###♦### 






01B30 


i THIS 


ROUTINE 


WILL LOAD A BASIC 


PROGRAM WITH NO FILENAME 






01B40 


; u nut ttt mi nm mm tituitituiim milium m 






01850 


; 








70CF 


F3 


01BE0 


TEHPER 


DI 




GET RIO OF BOTHERS 


70D0 


2A8140 


01870 




LD 


HL, (40B1H) 


GET TOP OF BASIC MEMORY 


7DD3 


ED5BA440 


018 80 




LO 


DE,(40A4H) 


GET BASIC PROGRAM PTR. 


70D7 


05 


01890 




PUSH 


DE 


SAVE IT A MOMENT 


70D8 


ED52 


01900 




SBC 


HL.DE 


GET MEMORY AVAILABLE 


70DA 


E5 


01910 




PUSH 


HL 


GET READY FOR TRANSFER 


70DB 


C1 


01920 




POP 


BC 


COUNT OF MEMORY IS IN B 


700C 


E1 


0193 




POP 


HL 


BEGINNING OF BASIC ■ HL 


70DD 


C5 


01940 




PUSH 


BC 


SAVE AVAILABLE MEMORY 


7DDE 


CDA570 


01950 




CALL 


REDSYN 


CALL HEAD SYNC ROUTINE 


70E1 


C1 


01960 




POP 


BC 


RESTORE AVAILABLE MEH. 


70E2 


cs 


01970 


TREAD 


PUSH 


BC 


SAVE BYTE COUNT 


7 0E3 


CD7C70 


01980 




CALL 


HEAD 


READ ONE BYTE 


70E6 


71 


01990 




LD 


(HL) ,C 


GET VALUE TO VIDEO MEM 


70E7 


C1 


02000 




POP 


BC 


GET BYTE COUNT BACK 


7DE8 


OB 


02010 




DEC 


BC 


REDUCE COUNT BY ONE 


70EB 


78 


02020 




LD 


A,B 


GET HIGH BYTE OF MEMORY 


70EA 


B1 


02030 




OB 


C 


AND CHECK AGAINST LOW 


70EB 


CA9719 


02040 




JP 


Z.1997H 


DM ERROR IF TOO MUCH 


7GEE 


7E 


02050 




LD 


A,(HL) 


GET VALUE IN HL 


70EF 


A7 


02060 




AND 


A 


TEST IF A ZERO 


70F0 


C20271 


02070 




JP 


NZ.JUMP3 


PAST FLASH IF OKAY 


70F3 


3A3F3C 


020BO 




LD 


A, [3C3FHJ 


GET PLACE ON SCREEN 


7DF6 


EEOA 


02090 




XOR 


OAH 


AND TOGGLE STAR & SPACE 


70F8 


323F3C 


02100 




LD 


[3C3FH] ,A 


AND PUT BACK ON SCREEN 


70FB 


28 


02110 




DEC 


HL 


GO BACK SPACE FOR TEST 


70FC 


7t 


02120 




LD 


A,(HL) 


GET VALUE THERE 


70FD 


A7 


C2130 




AND 


A 


TEST IF A ZERO ALSO 


7QFE 


CA0571 


02140 




JP 


Z.JUMP4 


GO TO END ROUTINE IF 


7101 


23 


02150 




INC 


HL 


BACK TO PROPER BYTE 


7102 


23 


D2160 


JUMP3 


INC 


HL 


READY NEXT MEM LOC'N 


7103 


1BDD 


02170 




JB 


TREAD 


AND THEN GO BACK 


7105 


23 


02180 


JUMP4 


INC 


HL 


GET NEXT MEMORY LOC'N 


7106 


AF 


02190 




XOR 


A 


LET A BE EQUAL TO ZERO 


7107 


77 


02200 




LD 


[HL) ,A 


AND PUT IT IN PLACE 


7108 


ED5BA440 


02210 




LO 


DE,(40A4H) 


GET START OF PRGRM PTR 


710C 


3EFF 


02220 




LD 


A, OFFH 


GET RESETTING CODE 


710E 


12 


02230 




LO 


IDE) ,A 


PUT AT PROGRAM START 


710F 


CDFC1A 


02240 




CALL 


1AFCH 


RESET ALL LINE NUMBERS 


7112 


23 


02250 




INC 


HL 


HL MOVED PAST PROGRAM 


7113 


22F940 


02260 




LD 


[40F9H1 ,HL 


SIMPLE VARIABLE POINTER 


7116 


CDC901 


227 




CALL 


01C9H 


CLEAR THE SCREEN NOW 


7119 


CD611B 


02280 




CALL 


1B61H 


CLEAR ALL THE POINTERS 


711C 


CDFE01 


02290 




CALL 


01FEH 


TURN CASSETTE OFF 


711F 


C3CC06 


02300 
2310 




JP 


06CCH 


GO TO BASIC "READY" 






02320 


■ itntn 


immmmmmmm 






02330 


; THIS 


ROUTINE 


IS A GERMINAL ROU 


riNE TO CSAVE A PROGRAM 






23 40 


; WITHOUT A PROGRAM NAME. FORMA 


r: /PUT. THE 500-BAUD 






02350 


; BLOCK 


SAVE CAN BE USED AS AN E 


<AHPLE OF HOW TO EMPLOY 






02360 


; A PROGRAM NAME IN SAVING A PRO 


SRAM. 






02370 


; imiiniiitiiiiiittiiiiiinu 


immmmmmmm 






23 90 










7122 


F3 


02390 


TEMPEX 


DI 




, GET RID OF BOTHER 


7123 


3E2A 


02400 




LD 


A, BAH 


; GET READY AN ASTERISK 


7125 


323E3C 


2410 




LD 


(3C3EH) ,A 


PLACE STAR ON SCREEN 


7128 


323F3C 


02420 




LD 


(3C3FH) ,A 


; PLACE STAR NEXT TO IT 


712B 


2AA440 


02430 




LD 


HL, (40A4H) 


, START OF BASIC PROGRAM 


712E 


ED5BF94C 


2440 




LO 


DE , ( 4DF9H) 


; BOTTOM OF VAR. POINTER 


7132 


CD5F70 


02450 




CALL 


SYNCHR 


: WRITE LEADER AND SYNC 


7135 


7C 


0246 


L0000P 


LD 


A,H 


; GET CURRENT HIGH MSB 


7136 


BA 


02470 




CP 


D 


; SAME AS TARGET MSB? 


7137 


C23F71 


024B0 




JP 


NZ.JUMP01 


; CONTINUE IF NOT SAME 


713A 


7D 


02490 




LD 


A,L 


i SAME HI MSB - READY LOW 


7138 


BB 


02500 




CP 


E 


; SAME AS TARGET LSB? 


713C 


CA5671 


02510 




JP 


Z.GOOUT 


; DONE WITH SAVE IF SO 


713F 


7E 


02520 


JUMP01 


LD 


A.IHL) 


i ELSE GET VALUE IN MEM 


7140 


A7 


02530 




AND 


A 


; TEST IF A ZERO 


7141 


C24E71 


02540 




JP 


NZ.JUHP02 


; JUST GO ON IF NOT 


7144 


F5 


02550 




PUSH 


AF 


; SAVE VALUE IN A 


7145 


3A3F3C 


02560 




LD 


A, (3C3FH) 


; GET TOGGLE VALUE TO A 


714B 


EEOA 


02570 




XOR 


OAH 


; TOGGLE STAR & SPACE 


71 4A 


323F3C 


02560 




LD 


(3C3FH) ,A 


; AND PUT IT ON SCREEN 


7140 


F1 


02590 




POP 


AF 


j GET VALUE BACK TO A 


714E 


4F 


026 00 


JUMP02 


LO 


C,A 


; PUT BYTE IN C REGISTER 


714F 


CD0070 


02610 




CALL 


WRITE 


; WRITE BYTE TO TAPE 



case is $5.00. Photo 1 shows the unit mounted 
inside the smallest Radio Shack equipment box. 

Eight-level (eight bit) paper tape is capable of 
storing parallel bytes of data by means of holes 
punched in the tape. A smaller, ninth hole - 
placed between the third and fourth holes - 
provides a timing signal for the reading program. 

The ninth hole also can be used as a data-ready 
signal. By the time the light just triggers the 
circuitry as it passes along the edge of the smaller 
hole, the larger holes are letting in plenty of light 
for the data to be stable, ready to read. 

The TPR-1 comes ready to hook to a computer 
bus. Its output is in parallel, and all signals are 
tri-state. Because it uses only 12 mA, it's possible 
to run the reader directly from the TRS power 
supply. 

Figure 9-4 presents the diagram of the 
TPR-1. The low-power CMOS integrated 
circuits Ul and U2 evaluate the state of the data 
as seen by the light-sensitive transistors and 
provide a parallel output. Part of U2 is also used 
to drive the LED, which blinks on whenever data 
is stable at the output of the reader. 

Figure 9-5 is the TRS-80 interface schematic. 
Zl and Z2 decode the port address 3F in order to 
activate tri-state buffer Z3. This separate port 
decoding is necessary because the TPR-1 was not 
designed with the READY line separately 
activated from the data lines. Were that the case, 
READY might be tested at all times. That way, 
data would only be input whenever READy 
indicated stable data. In its present 
configuration, however, a separate buffer must 
be used for the TPR-1 data lines. 

Z4 is a flip-flop which produces an interrupt 
signal and sends it to the TRS-80 INT line; 
INTAK (interrupt acknowledge) is used to clear 
the interface flip-flop when data has been read. 
This configuration is similar to that used for the 
interrupt based real time clock (see Chapter 8 )• 

The circuit can be wire-wrapped on a small 
piece of perfboard and mounted inside a case 
with the TPR-1. A detachable 40-pin cable can 
also be used to save a few dollars. 

Listing 9-2 presents the software to read one 
page (256 bytes) of data into the TRS-80 and 
store it in memory. Recall that the interrupt 
patch point at 4012 is initialized with C9, a 
RETurn instruction. In its place, then, a patch 
must be made to one of three interrupt service 
routines which will read each byte of data as it 
becomes stable at the output of the TPR-1. Since 
the reader will not likely be a device used very 
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A Paper Tape Reader 



71 62 S3 
7153 C33571 
71 86 CDFE01 
7159 C9 



BITEX 

GOOUT 

INSIG 

JUMP01 

JUMP02 

JUMP3 

JUMP4 

LO0O0P 

READ 

HEDBIT 

REOEX 

REDSYN 

REBX2 

RLOUP 

SYLOOP 

SYNCHR 

SYNCLP 

TEMPER 

TEMPEX 

TIMEX 

TREAD 

WLOOP 

WRITE 



02620 

02630 

26 40 

02650 

02660 

02670 

02680 

02690 

D2700 

02710 

02720 

7036 00670 

7156 02640 

70C7 01760 

71 3F 02520 

71 4E 02600 

7102 02160 

7105 021B0 

7135 02460 

707C 01160 

709C 01430 

708A 01280 

70A5 01540 

70BD 01290 

707E 01170 

7D69 01010 

705F 00970 

7DB6 01620 

70CF 01860 

7122 02390 

7014 00440 

70E2 01970 

7008 00330 

7000 00280 



INC 
JP 
GOOUT CALL 
RET 



HL 

LOOOOP 

01FEH 



^ 



GET NEXT MEMORY LOC'N 
LOOP AROOND FOREVER 
TORN OFF CASSETTE 
BACK TO MAIN ROUTINE 



tuifnimmittunutntttttiiuiitiittmiii *#«#««* 

REMEMBER: ENTRY POINT FOR SAVE ROOTINE IS TEMPEX 
REMEMBER: ENTRY POINT FOR LOAD ROUTINE IS TEMPER 

iiiiitiiiiiiitniiiimiitiiimtiitiitiuiiiuiiitiiii 



often, this kind of interrupt-hogging is not a 
problem. If you have a Teletype with a built-in 
paper punch, though, you might want to 
configure this interrupt software so it can be 
patched in only when it's needed. 



END 
00360 
02510 

01280 01360 
02480 
02540 
0207D 
02140 
02E30 
01980 

01180 01570 01630 
01170 01560 01620 
01590 01700 01950 
01310 
01210 
01070 
02450 
01660 



00330 
02170 
00370 
01030 01090 02610 



Mores - 

l OUTPUT DATA IS TRUE 
I.E A "ONE' (HOLE) ON THE 
TAPE GIVES A HIGH 15V) 
VOLTAGE LEVEL OUTPUT 

2 MAXIMUM LOADING ON ANT 
OUTPUT IS TWO STANDARD 
TTL LOADS 

S 01 THAU 09 • MROISO 

OPTICALLT MATCHED. 00 NOT 
SUBSTITUTE 



~y» .jj =£>=■ 



"-y« !jj ^z> 




;^r-5^ 



~\& JzS~^t> 



~y°< ^j ~^E> 



• B8 

• BT 

• 36 

• 8? 

• B4 

• FEED 

• BS 

• B2 

• Bl 

TAPE MOTION 



- PI-8 ENABLE 



Photo 9-6. Paper tape reader. 

TPR-1 tape reader has machined aluminum track and data 

indicator LED. 




Only four integrated circuits form the complete tape reader 
interface. Power supplies both reader and interface. 



Figure 9-5. TPR-1 interfacing schematic. 



The program is entered at line 1160. The 
screen is cleared, and the user is prompted to 
enter a base address in hex. This is the address 
starting at which the tape data is to be loaded 
into memory. The keyboard is scanned for 
characters to 9 and A to F; these are displayed, 
and when ENTER is pressed, the character? are 
converted to a starting address. 

The tape must be threaded before actual data 
reading is begun, because during threading it's 
possible to present false information to the 
TRS-80. The tape reading is begun at line 1740. 
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Listing 9-3. Paper tape reader program. 



4013 
06CC 
3CD0 



4012 
4012 C3 
7000 



7000 21003C 
7D03 11013C 
7D06 01FF03 
7009 3S20 
700B E080 
7D00 C9 



7D0E 3A4038 
7011 FE02 
7D13 20F9 
7D1S C9 



7016 7E 

7D17 A7 

7018 CB 

7D19 12 

7D1A 23 

7D1B 13 

7D1C 18FB 



7D1E F5 
7D1F E6F0 

7021 1F 

7022 IF 
7D23 1F 
7D24 1F 
7D2S FEOA 
7D27 3004 
7D29 CB30 
7D2B 1802 
7D2D CB37 
7D2F 77 
7D30 23 

7031 F1 

7032 EBOF 
7D34 FEOA 
7D36 3004 
7D38 C630 
7D3A 1802 
703C C637 
7D3E 77 
7D3F C9 



7040 F3 
7D41 AF 
7042 C9 



7D43 F3 
7D44 DB3F 
7D46 CD1E7D 
7D49 AF 
704A C9 



00100 
00110 
00120 
00130 
00140 
00150 
001B0 
00170 
00180 
00180 
00200 
00210 
00220 
230 
00240 
00250 
00260 
00 27 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
00460 
0047 
00480 
00490 
00500 
00510 
00520 
00530 
540 
00550 
00560 
00570 
005B0 
00590 
00600 
00610 
00620 
00630 
00640 
00650 
00660 
00670 

006 80 
00680 
00700 
00710 
00720 
00730 

007 40 
00750 
00760 
00770 
07 80 
00790 
0800 
00810 
00820 
00830 
00840 
00850 
00860 
00670 
00980 
00890 
00900 
0091 
00920 
00930 
00940 
00950 
00960 
00970 
00960 
009 90 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 
01060 



II I III 1111111111111 1111111 till,,, I It III, l,,,,tmmm 

TAPE READER AND 256-BYTE LOADER ROUTINE 
DENNIS BATHORY KITSZ, ROXBURY, VERMONT 05669 

timmmmmimmmmtmm nt, 1,1,11,1,1m, 



VECTOR EttU 
BASIC EQU 
VIDEO EQU 



4013H 
06CCK 
3C0OH 



;INTERRUPT VECTOR PATCH 
;RETURN TO BASIC READY 
[BEGINNING OF SCREEN 



ii mum tt tint i tntittttm it mi i ii ut ti tti tt u tin 

INTERRUPT VECTOR'AT 4012H 

iiimmmtmmmmmitmmmttmmtmim 



ORG 401 2H 
DEFB 0C3H 
ORG O7D00H 



[CURRENT VALUE IS C9 
iREPLACE WITH JUMP 
[ROUTINES BEGIN HERE 



iimimmimmiimmmmimmmmmmm 

CLEAR SCREEN SUBROUTINE 

it iiimmimmimmmmtmmm mimmmt 



LD 


HL, VIDEO 


iGET START OF VIDlO 


LD 


DE.VIDEO+1 


;GET DESTINATION POINT 


LD 


BC.03FFH 


;GET MEMORY BLOCK SIZE 


LD 


(HL) ,20H 


[WRITE SPACE INTO VIDEO 


LDIR 




[BLOCK MOVE CLEAR SCREEN 


RET 




[BACK FROM SUBROUTINE 



iiimimmtmmmmmmimmmmimmm 

SCAN FOR ENTER SUBROUTINE 

tt mmimmmmmmmmiimmmtmmim 

;"ENTER" KEYBOARD ROW 
; "ENTER" KEYBOARD COLUMN 
;L00P UNTIL KEY PRESSED 
;BACK FROM SUBROUTINE 

u i m it mim mm mm mimmmt mm mum 

DISPLAY MESSAGE SUBROUTINE 

ti mmmmmmmmmmmmmimmitttm 



LD 


A, [3840HJ 


CP 


2 


JR 


NZ, ENTER 


RET 





LD 

AND 

RET 

LD 

INC 

INC 

JR 



A, (HL) 

A 

Z 

(DE) ,A 

HL 

DE 

0ISPLY 



iGET BEGINNING OF TEXT 
iCHECK IF A NULL 
;EXIT SUBROUTINE IF NULL 
[DISPLAY CHARACTER IN A 
;GET NEXT MESSAGE LOC'N 
;GET NEXT SCREEN LOC'N 
;L00P FOR CHARACTER TEST 



; mmimmimmmmmmimmimmmmm 

; CONVERT TO ASCII SUBROUTINE 

; mm mtmtmimmtmmimmm m mumm 



C0NVRT 



HIBYTE 
NEXT 



HIBTE2 
NEXT2 



PUSH 

AND 

RRA 

RRA 

RRA 

RRA 

CP 

JR 

ADO 

JR 

ADD 

LD 

[NG 

POP 

AND 

CP 

JR 

AOL) 

JR 

ADD 

LD 

RET 



AF 

0F0H 



0AH 

NC, HIBYTE 

A.30H 

NEXT 

A,37H 

[HL] ,A 

HL 

AF 

OFH 

OAH 

NC.HIBTE2 

A.30H 

NEXT2 

A,37H 

(HL) ,A 



;SAVE ACCUH. AND FLAGS 
iMASK OUT LOW 4 BITS 
iMOVE NIBBLE TO RIGHT.. . 
i ...SOME MORE 
; ...SOME MORE 
; . ..UNTIL DONE 
; IS IT TEN OR GREATER? 
iMOVE ALONG IF > TEN 
i ASCI I ■ NUMBER PLUS 30H 
; GO ON TO LOW NIBBLE 
;ASCII ■ NUMBER PLUS 37H 
;DISPLAY FIRST ASCII CHAR 
;GET NEXT SCREEN LOC'N 
[RESTORE ORIGINAL HEX 
[MASK OUT HIGH 4 BITS 
;IS IT TEN OR GREATER? 
iMOVE ALONG IF > TEN 
iASCII - NUMBER PLUS 30H 
;G0 TO DISPLAY & OUT 
[ASCII ■ NUMBER PLUS 37M 
[DISPLAY NEXT ASCII VALUE 
[BACK FROM SUBROUTINE 



ummmmtmmmimmimimmtmmmm 

CLEAR TAPE READER INTERRUPT ACKNOWLEDGE 

ii mmmmmmmtmmmmimmmimtmi 



DI 
XOR 

RET 



[INTERRUPT OFF IN SERVICE 
[CLEAR ACCUM. & FLAGS 
[BACK FROH SUBROUTINE 



mitmimmmmmmmmmmmmmmmt 

PAGE ADDRESS INTERRUPT SERVICE 

ti mmmmimtmmmmmmmmmmmm 

[INTERRUPT OFF IN SERVICE 
[GET VALUE FROM READER 
[CONVERT VALUE TO ASCII 
[CLEAR ACCUM. & FLAGS 
[BACK FROM SUBROUTINE 

ii immmmimmmmmmmmmmmmm 

READ DATA / PLACE ON SCREEN INTERRUPT 

ii mmmmimmmimmmmimmmiimm 



DI 




IN 


A, OFH) 


CALL 


C0NVRT 


XOR 


A 


RET 





SERVE2 DI 



[INTERRUPT OFF IN SERVICE 

Listing Continued . . . 



With the software shown, the tape to be read 
must be in the following format: 

1-byte code of information (tape number, 
address page, etc.), which is displayed but 
not to be stored in memory. 

256 bytes of data. 

1-byte simple checksum. 

If the tape is not in this format, the program 
can be easily altered to accommodate any other 
256-byte data block format. 

Interrupts are then enabled (lines 1810-1820), 
and a series of short interrupt service routines are 
activated. The first routine merely waits for the 
interrupt line to clear, as it may have been set by 
stray light in the room when the tape is threaded 
(lines 1820-1870). 256 bytes are then loaded and 
displayed (lines 1910-2030). The checksum is 
calculated and displayed (lines 2050-2130), and 
the checksum is read from tape and displayed 
(lines 2150-2280). If there is a match, the 
memory pointer is advanced in order to read the 
next block of tape; otherwise, it is reset to the 
beginning of the block, allowing the tape to be 
read again, (lines 2210-2420). Finally, the option 
of loading additional blocks or returning to 
BASIC is presented (lines 2440-2540). 

Using the TPR-1, the interface, and this 
simple software, the wealth of 8080 programs, as 
well as programs saved in an archival paper tape 
format, may be read into your TRS-80 and used. 



An 8-Track Mass Storage System 

Oh, no! Here comes another one! I'd like to 
join the mass storage fray with another device 
capable of loading and saving programs at high 
speed. It's not as slow as a cassette, not as fast as 
a Stringy-Floppy, but it has one interesting 
capability: sequential-random access. That's a 
mythical term for sequential access of more than 
one track at a time. 

Here's how it works: 8-track cartridges play 
one-quarter their total length on each pass. Then 
the head switches from the first stereo pair to the 
second, the second to the third, the third to the 
fourth, and from the fourth back up to the first. 
A so-called '40-minute' cartridge is actually 10 
minutes long, four passes. The shortest 
commercially available cartridges are 20 minutes 
long, five minutes per pass. 
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Continued Listing 



704C DB3F 
7D4E 77 
7D4F 81 
7D5Q 4F 
7D51 23 
7D52 AF 
7D53 C9 



7D54 F3 
7D55 DB3F 
7D57 47 
7DS8 AF 
7D58 C9 



7D5A 54 
7D76 00 
7077 4C 
7D8E 00 
7D8F 42 
7DAB 00 
7DA9 43 
7DC2 00 
7DC3 43 
70DS 00 
7DDA 43 
7DF7 00 
7DF8 42 
7E0F 00 
7E10 41 
7E3S 00 
7E3A 50 
7E59 00 



7E5A CD007D 
7E5D 215A7D 
7EB0 11003C 
7E83 CD167D 
7E66 C00E70 



7E69 
7E6C 
7E6F 
7E72 
7E75 
7E7 8 
7E79 
7E7B 
7E7C 
7E7E 
7E81 
7E84 
7E87 
7EB8 
7E89 



7EBB 
7EBE 
7E91 
7E94 
7E97 
7E9A 
7E9D 
7E9E 
7E9F 
7EA1 
7EA2 
7EA3 
7EA5 



21777D 

11403C 

CD1B70 

214070 

221340 

37 

ED56 

FB 

38FE 

21437D 

221340 

21573C 

37 

F8 

3BFE 



21BF7D 

11B03C 

CD1670 

214B7D 

221340 

210030 

AF 

4F 

0600 

37 

FB 

3BFE 

10FA 



7EA7 21547D 
7EAA 221340 
7EA0 21A970 
7EB0 11403E 
7EB3 CD167D 
7EB6 79 
7EB7 D5 



01090 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
01170 
01180 
01190 
01200 
01210 
01220 
01 23 
01240 
01250 
01260 
01 27 
01280 
01290 
01300 
01310 
01320 
01330 
01340 
01350 
01360 
01370 
01380 
01390 
01400 
0141 
01420 
0143 
01440 
01450 
01460 
01470 
01480 
01480 
01500 
01510 
01520 
0153 
01540 
01550 
0156 
D1570 
015B0 
01590 
01600 
01610 
01620 
01630 
01640 
01650 
01660 
01670 
01680 
01690 
01700 
01710 
01720 
01730 

017 40 
01750 
01760 
01770 
01780 
01780 
01800 
01810 
01820 
01830 
01840 
01B50 
01860 
01B70 
01880 

018 90 
01900 
0191 
01920 
01930 

019 40 
01950 
01960 
01970 
01980 
01990 
02000 
02010 
02020 
02030 
02040 
02050 
02060 
02070 
020B0 
02090 
02100 



GET VALOE FROM READER 
POT IT INTO MEMORY 
GET VALUE FROM CHECKSUM 
RESTORE UPDATED CHECKSUM 
GET NEXT MEMORY LOC'N 
CLEAR ACCUM. a FLAGS 
BACK FROM SUBROUTINE 



it tin tttti it ttm mini mm mt m mint ttiunni 

CHECKSUM INTERRUPT ROUTINE 

ff ffffff III I HI lilt mill HUH ffffff ffffff ffffff ffffff 



IN 


A, (3FH) 


LD 


[HLJ ,A 


ADD 


A,C 


LO 


C,A 


INC 


HL 


XOR 


A 


RET 





DI 

IN 

LD 

XOR 

RET 



A,[3FH) 
B,A 

A 



INTERRUPT OFF IN SERVICE 
GET VALUE FROM READER 
SAVE IT IN B REGISTER 
CLEAR ACCUM. & FLAGS 
BACK FROM SUBROUTINE 



u mt mil mnmmm tin mini m unit t mil mi 

MESSAGES FOLLOW 

II I ill 1 1 1 lltlitlt mi I It I III II 1 1 1 1 1 1 1 1 It 1 1 1 1 1 1 It 1 1 1 1 It I 



MSGN01 DEFM 

DEFB 
HSGN02 DEFM 

DEFB 
MSGN03 DEFM 

DEFB 
MSGN04 DEFM 

DEFB 
MSGN05 DEFM 

DEFB 
MSSN06 UEFM 

DEFB 
HSGN07 DEFM 

DEFB 
MSGN08 DEFM 

DEFB 
MSGN09 DEFM 

DEFB 



'THREAD TAPE AND PRESS CLEAR.' 

00 

'LOADING PAGE ADDRESS: ' 

00 

'BYTES LOADING AS FOLLOWS:' 

00 

'CALCULATED CHECKSUM IS: ■ 

00 

'CHECKSUM AS READ IS: ' 

00 

'CHECKSUM ERROR IN THIS BLOCK.' 

00 

'BLOCK LOADED CORRECTLY.' 

00 

'ANOTHER BLOCK? REPLY 1 FOR YES, 2 FOR NO' 

00 

'PRESS CLEAR TO RETURN TO BASIC' 

00 



iimmmmmHmmmmmmmmmmmm 

REMEMBER THIS IS ENTRY POINT AND NOTI 

BEGINNING OF PROGRAM 

CLEAR SCREEN, DISPLAY "THREAD" MESSAGE 

iiimmmmiiiiiiiiiimiimmiiimmimiiiiii- 



START 



CALL 

LD 

LO 

CALL 

CALL 



CLEAR 
HL.MSGN01 
DE, VIDEO 
DISPLY 
ENTER 



OUT TO CLEAR SUBROUTINE 

GET MESSAGE #1 LOCATION 
GET OISPLAY LOCATION 
OUT TO OISPLAY SUBROUT. 
WAIT FOR ENTER SUBROUT. 



iimmmmimmmmmmmmmmmiiiim 

DISPLAY "ADDRESS" MESSAGE a FIND IT 

iHmmmmmmmmmmmmmimiiiiimi 



LD 
LD 

CALL 
LO 

LD 
SCF 

IM 

EI 

JR 

LD 

LD 

LD 

SCF 

EI 

JR 



HL.MSGN02 
DE.VIDE0+40H 
DISPLY 
HL.SERVEO 
(VECTOR! ,HL 



C,( 

HL.SERVE1 
[VECTOR] ,HL 
HL.VIDE0+57H 



C,« 



GET MES 
GET DIS 
OUT TO 
GET INT 
INSTALL 
CARRY F 
SET INT 
INTERRU 
SUBROUT 
GET INT 
INSTALL 
GET DIS 
CARRY D 
INTERRU 
SUBROUT 



SAGE f2 LOCATION 
PLAY LOCATION 
OISPLAY SUBROUT. 

11 SERVICE ROUT. 

AT INT. VECTOR 
LAG IS IMPORTANT 
ERRUPT MODE 
PTS ON a WAITING 
INE CLEARS CARRY I 

f2 SERVICE ROUT. 

AT INT. VECTOR 
PLAY LOCATION 
ETERMINES LOOP 
PTS ON a WAITING 
INE CLEARS CARRYI 



iimmmmimmmmmmHiimmmmmm 

DISPLAY "BYTES" MESSAGE a LOAD 256 

mmmmmmmmmmmmmiimimmmi 



LO 


HL.MSGN03 




GET MESSAGE #3 LOCATION 


LD 


DE,VIDE0+80H 


GET DISPLAY LOCATION 


CALL 


DISPLY 




OUT TO DISPLAY SUBROUT. 


LO 


HL.SERVE2 




GET INT (3 SERVICE ROUT. 


LD 


[VECTOR) , 


HL 


INSTALL AT INT. VECTOR 


LD 


HL.VI0E0+ 


100H 


GET FIRST OISPLAY LOC'N 


XOR 


A 




CLEAR ACCUM. a FLAGS 


LD 


C,A 




CLEAR CHECKSUM REGISTER 


LD 


B.OOH 




LOAD B REGISTER WITH 256 


SCF 






INSTALL "JR C" LOOP 


EI 






INTERRUPS ON a WAITING 


JR 


c, » 




SUBROUTINE CLEARS CARRYI 


DJNZ 


L00P2 




WRITE ONE PAGE TO MEMORY 



iiimmmmmmmmmmmmiiiimmmm 

DISPLAY "CHECKSUM CALC" MESSAGE 

ti imimm mi mmmmmimmmmmmim 



LD 

LD 

LD 

LD 

CALL 

LD 

PUSH 



HL.SERVE3 

(VECTOR) ,HL 

HL.MSGN04 

DE,VIDEO+240H 

DISPLY 

A,C 

DE 



GET INT 14 SERVICE ROUT. 
INSTALL AT INT. VECTOR 
GET MESSAGE f4 LOCATION 
GET DISPLAY LOCATION 
OUT TO DISPLAY SUBROUT. 
GET CHECKSUM CALCULATION 
SAVE DISPLAY INFORMATION 

Listing Continued . . . 



For this system, the shortest 8-track cartridges 
are used in an 8-track deck with an electrical 
fast-forward mode. There are several loading 
options: 

1. Load the next program on the tape from 
the current track. The machine 
fast-forwards to the next leader and loads 
the program. 

2. Load the next program on the tape, with 

the track specified. The machine moves to 
the specified track, fast-forwards to the next 
leader, and loads the program. 

3. Load the program specified from the 
track specified. The machine moves to the 
appropriate track and reads leaders (in 
fast-forward mode) until the program is 
found, and then loads it. 

4. Load the program specified; the machine 
moves ahead and reads the directory 
immediately following the splice. The 
program is located and read. 

In this way, where the locations of programs 

are known, they may be loaded immediately. 
Otherwise, the device is somewhat directory 
organized. I add this reservation because the 
tape is sequential and programs can't be killed 
easily unless the tape is re-organized. More on 
that later. 

The advantage of this system is obvious: it 
provides somewhat faster access and loading 
than cassettes, and allows fairly fast search and 
storage. In the fast-forward mode, 20-minute 
8-track tapes can be run through completely in 
less than two minutes. Worst-case program 
access is then two minutes - when you have just 
passed the program you want to load. 
Furthermore, eight individual programs can be 

stored parallel to each other on the cartridge's 
tracks. 

As noted, to build this device, an electrical 
fast-forward is necessary. Check the manuals for 
a two-speed motor; the Craig model H240 
playback-only deck is the kind I used. Some 
modifications are necessary to the tape recorder 
itself, and alignment is a bit more critical. 
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Continued Listing 



7EB8 El 
7EBS CD1E7D 



7EBC 21C37D 
7EBF 118Q3E 
7EC2 CD167D 
7EC5 FB 
7EC6 37 
7EC7 3BFE 



7EC9 7B 

7ECA D5 

7ECB E1 

7ECC CD1E7D 

7ECF 7B 

7ED0 B9 

7ED1 280B 



7ED3 21DA7D 

7ED6 11CD3E 

7ED9 CD167D 

7EDC 1809 



7E0E 21FB7D 
7EE1 11C03E 
7EE4 CD167D 
7EE7 21107E 
7EEA 11003F 
7EED CD1670 



7EF0 
7EF3 
7EF5 
7EF8 
7EFA 
7EFC 
7EFE 
7F01 
7F04 
7F07 
7F0A 



3A1038 

FE02 

CA5A7E 

FE04 

2802 

18F2 

213A7E 

11403F 

CD167D 

CD0E70 

C3CC06 



7E5A 

00000 TOTAL 



02110 
02120 
02130 
02140 
02150 
02160 
02170 
02180 
02180 
02200 
02210 
02220 
02230 
02240 
02250 
02260 
227 
02280 
02230 
C2300 
2310 
23 20 
02330 
02340 
02350 
02360 
02370 
23 60 
23 90 
02400 
2410 
02420 
02430 
02440 
02450 
02460 
02470 
024B0 
02490 
02500 
02510 
02520 
0253 
02540 
02550 
02560 
02570 
02580 
02590 
02600 
02610 
26 20 
02630 
26 40 
02650 
2660 
26 70 
26 80 
26 80 
027D0 
02710 
02720 
02730 
27 40 
ERRORS 



POP 
CALL 



HL 

CONVRT 



[TRANSFER IT TO HL PAIR 
iCNVRT. CHECKSUM TO ASCII 



LD 


HL.MSGN05 


LD 


DE.VIDEO+2B0H 


CALL 


DIEPLY 


EI 




SCF 




JR 


o, s 



timmmttiimmmimtitmmmtmttmmm 

DISPLAY "CHECKSUM READ" MESSA6E & DO IT 
mmmmmmmmmmmmmmmmmmi 

JGET MESSAGE #5 LOCATION 
(BET DISPLAY LOCATION 
;0UT TO DISPLAY SUBROUT. 
{INTERRUPTS ON & WAITING 
i CARRY FLAG LOOP SET 
[SUBROUTINE CLEARS CARRYI 

mmmmmmmiimmmmmmmmmmii 

DISPLAY CHECKSUM AND CHECK IT 

mmmmmmmmmmmmmtmmmmm 



;GET READ CHECKSUM BACK 
;STASH DE REGISTER PAIR 
{TRANSFER TO HL PAIR 
;CNVRT. CHECKSUM TO ASCII 
;GET VALUE AGAIN FROM B 
iCHECK WITH CALC CHECKSUM 
; CHECKSUM OKAY IF A MATCH 



mmmmmmmmmmmmmtmmmmm 

DISPLAY CHECKSUM BAD MESSAGE 

mmmmmtmmmmmmmmmmmmm 

[BET MESSAGE IB LOCATION 
;GET DISPLAY LOCATION 
iOUT TO DISPLAY SUBROUT. 
[LOAD COMPLETE - GO OUT 

; mmmmmmmmmmmmmmmmmmi 

; DISPLAY CHECKSUM OKAY MESSAGE 

; it ttmnii tint mm mum tint mini in i tun ti ii 



LD 


A,B 


PUSH 


DE 


POP 


HL 


CALL 


CONVRT 


LD 


A,B 


CP 


C 


JR 


Z.CKSMOK 



LD 


HL.MSGN06 


LD 


DE.VIDE0+2C0H 


CALL 


DISPLY 


JR 


LEAVE 



CKSMOK 



LD 

LD 

CALL 

LD 

LD 

CALL 



HL.MSGN07 

DE.VIDE0+2C0H 

DISPLY 

HL.MSGNOS 

DE.VIDE0+300H 

DISPLY 



;GET MESSAGE »7 LOCATION 
;GET DISPLAY LOCATION 
;0UT TO DISPLAY SUBROUT. 
[SET MESSAGE #8 LOCATION 
;GET DISPLAY LOCATION 
;0UT TO DISPLAY SUBROUT. 



mmmmmmmmmmmmmmmmmmi 

SCAN KEYBOARD FOR 1 OR & 00 IT 

mimmimmtmmmmmmmmmmmmi 

INDYN LO A.I3810HI [BET 0-7 KEYBOARD RON 

CP 2 [IB IT NUMBER ONE? 

JP Z, START ;BACK TO START IF SO 

CP 4 ;IS IT NUMBER TWO? 

JR Z.DONE [FINISHED ROUTINE IF SO 

JR FINDYN ;KEEP LOOKING IF NEITHER 

ONE LD HL.MSGN09 [GET MESSAGE #9 LOCATION 

LD DE,VIDE0+340H [GET DISPLAY LOCATION 

CALL DISPLY [OUT TO DISPLAY SUBROUT. 

OOKNG CALL ENTER [LOOK FOR ENTER SUBROUT. 

JP BASIC [BACK TO BASIC READY 

mmmmmmmmmmti'immmmmmm 

END START [SYSTEM ENTRY POINT 



Eviscerating an 8-Track Cartridge 

Chances are that obtaining high quality 
8-track cartridges in short lengths won't be 
easy. It's not hard to make your own in roughly 
eight minute lengths - two minutes per track, 
with less than 60 seconds total access time. 
This will be enough for programs nearly 30,000 
bytes in length. 

Purchase a few cheap 8-tracks to experiment 
with. All you will need is a piece of wood, a 
pair of scissors, and a package of silver foil 
sensing tape. This is available at Radio Shack 
(catalog number 44-1155, under $2). 

Most 8-tracks are fastened together with 
plastic tabs recessed in holes on top or bottom 
of the case. There are usually five: one on each 
back corner, one under the label in the center, 
one through the capstan, and one to secure the 
remaining corner. First, insert the cartridge 
into a player and run it ahead to its splice. 

Make sure you are holding the cartridge with 
the label down. Slip a thin piece of hobby 
'half-round' - a round stick split lengthwise 
down the center - into each hole and push the 
tab back, splitting the plastic case gently with 
your hand. The dull end of a small crocheting 
hook also works well. When all the tabs are 
released, split the cartridge apart to about 
one-quarter inch. Now turn it over. Gradually 
lift the cartridge apart, being careful to note 
the tape path and exactly how much slack is 
present in the loop. 

Snip the splice out first clipping out a length 
of tape that runs to within an inch of the center 
hub. Take the loose end of the tape that winds 
around the outside of the tape 'pancake', and 
begin to pull it out. Let the hub spin freely as 
you do this, so that the tension on the wound 
tape does not change. Measure the tape 
removed (to produce the 37.5 feet for an 
8-minute cartridge) using this table: 



Total 


Total 


Remove 


to Create 


Cartridge Time 


Feet 


8-minute Cartridge 


20 minutes 


94 




56 


22 minutes 


103 




65 


30 minutes 


141 




103 


40 minutes 


188 




150 


44 minutes 


206 




169 


45 minutes 


211 




173 


B0 minutes 


281 




244 



Note: Do not use cartridges over 60 minutes Long. 

Sound time consuming? It can be if you 
measure a foot at a time. Instead, anchor the 
cartridge on a table, and pull the end of the 
tape across the room (or down the hall). If 
you've purchased a 40-minute cartridge, that's 
only ten trips. 
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Eviscerating an 8-Track Cartridge (5 photos). 




When you've removed all the tape you need 
to, leave the same amount of slack as before 
and splice the two ends together. The oxide 
(playing) side of the tape is spliced with metal 
foil sensing tape. Make sure you splice the 
same sides to each other! Now reroute the tape 
along the original path, holding it gently in 
place; use thin cloth gloves if your hands tend 
to perspire. 



Blunt tool is inserted in slots at bottom of the cartridge as the 
sides are separated and held steady. 





Excess tape is pulled gently from outside of the hub, letting hub 
and platter rotate freely. Note that end near center of hub has 
been cut fairly short to eliminate the possibility of tangling with 
the tape being removed. 



Cartridge is flipped right side up and top of case is removed 





Tape is removed from its path and cut at splice. 



When enough tape has been removed, ends are spliced together 
with silver sensing foil The tape is then re-routed and the case 
snapped back together. 



220 



Chapter 9 



An 8-Track Mass Storage System 



Without bending the tape or getting it 
caught, slip the cartridge top back in place. 
Note the front of the cartridge as you do this, 
making sure the tape does not slip on the 
outside of the 'window frames'. You now have 
an 8-minute cartridge, ready to use. 

If you end up with some slack tape hanging 
out of the cartridge, put on some thin cloth 
gloves. Now pull the tape out of the case gently 
from the end opposite the rubber puck. The 
tape will pull into the other end faster than it is 
being pulled out. When most of the slack is 
taken up, give a gentle tug with a bit of 'snap'; 
the momentum will spool the tape into the 
cartridge housing. 



If you are using the Craig H-240, the directions 
below will apply directly; since 8-track playback 
decks are similar, you can put some of them to 
use in remodeling your 8-track. It is also possible 
to purchase drives without electronics from 
surplus houses. These are sold for under $10, and 
come complete with head assembly, motor, and 
track-change solenoid. Be sure that you get one 
with a two-speed motor if you want to implement 
the fast forward features of the system; an 
excellent single-speed drive is sold for only $8 by 
BNF Enterprises. 

First of all, you should know that the deck 
won't be usable as an audio deck when you're 
done; so don't split up your hi-fi system in hopes 
that this 8-track storage system will serve double 
duty. 

1. Remove the case. Two screws hold the back 
panel, and screws through the four feet keep 
the frame attached to the housing. Set the 
back aside, and slide the electronics out 
through the front of the case. 

2. Pull off the buttons, and set them aside. 
Remove the four screws which hold the frame 
to the face plate, and set the face plate aside. 

3. Heat the soldering iron. You will be 
removing these wires: 

- The two wires connected to the on-off 
switch; contact is made when a cartridge is 
inserted in the deck. 

- The two wires from the foil sensor 
pickup. This is located about an inch from 
the on-off switch. 

- All wires running to the three switches 
underneath the deck. 



4. Remove the two front screws holding the 
three switches onto the front plate. Set this 
switch block aside; also remove all loose wires 
(those desoldered at both ends), and desolder 
the far ends of remaining wires which had run 
to the switches. 

5. Unscrew the electronics control board (two 
screws), which is found to the front of the 
transformer. Desolder all wires leading to this 
board, and discard the board, scavenge it for 
parts, or keep it. It is a legitimate 8-track 
preamplifier, and can still be used if you need 
such an animal. 

6. The following parts are still intact: 

- The motor and the three wires leading 
from it. These wires are still attached to a 
terminal strip. 

- The head assembly. This will be 
modified later. At present, it contains a 
shielded, three-wire cable leading from the 
playback head itself, and a five-wire 
assembly from the track-select switch. 

- The capstan, drive belt, and 
track-change mechanics. These remain 
intact. 

- The transformer. Three wires run from 
it; the center tap (black wire), won't be used, 
so cover it with tape or a wire nut. 

- The terminal strip and two audio output 
jacks. These will be used. 

By removing these parts, you have returned 
the drive to its 'naked' state. If you are using a 
surplus 8-track drive, this is the condition in 
which it will be shipped. 

To use this in a digital system, several 
important conditions have to be met: 

1. The recording and playback must be done 
in a digital format. 

2. The track, splice, and tape-in-place status 
must be readable by the computer. 

3. Speed must be controlled by the 
computer. 



Figure 9-6. presents the complete circuitry to 
convert the Craig H-240 to a digital 
record/playback system. Incoming data is 
latched by Z12 on the occurrence of the 
command OUT (0AAH),A and is buffered by 
Z2a/b. It is fed to a symmetrical pair of 
output-coupled buffers (Zl and Z6). 
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Since the output of these CMOS buffers is 
capable of rising very high (within a few 
millivolts of the 12-volt supply voltage), this 
provides a fast rising pulse to the recording head. 
The data is recorded in a bipolar manner: that is, 
when buffers Zla/b rise, Zlc/d fall, and vice 
versa. 

This information is recorded directly on the 
tape. During playback, the raw waveform is fed 
to Z4a, an LF353 FET operational amplifier (a 
plug-in replacement for the more commonly 
available LM747, which can be substituted with 
some signal degradation). This amplifier is set 
up in an inverted configuration with high gain; it 
produces a strong waveform which is then fed 
into Z4b, configured as a high-gain 'clipping' or 
'squaring' amplifier (contributed by diodes Dl 
and D2). 

This output is stabilized and buffered by 
comparator Z5a, and fed to Z5b (Z5 is a simple 
LM 339 comparator), arranged as a TTL-level 
driver. Z3a, a three-state inverter, is connected 
directly to a TRS-80 data line. 



Figure 9-7 provides drive status information. 
ZlOe is hooked to the former cartridge on-off 
switch, informing the computer of the presence 
of a cartridge in the drive. The track select 
switches feed their 12-volt signals to ZlOa-b, 
which report the track pair in use. The foil sensor 
triggers a flip-flop made up of Z8a/b, which 
latches the fact that the foil has passed, until the 
computer resets it via the RESET SPLICE line. 

The unit is turned on from the front, and 
power is always applied to the electronics. When 
the program reads or writes to tape, the motor is 
turned on via data bit 5; for fast read search and 
write, the motor is activated by data bit 6. The 
splice status is reset via data bit 3, and tracks are 
changed via data bit 4. Writing to the deck is 
enabled by data bits 1 and 2 (for the upper and 
lower of the track pairs, respectively), and the 
actual data writing is done through data bit 0. 

Addressing of port AA is provided by Zl4a-d 
and Z13, and this signal is combined with the 
computer's OUT and IN signals by Z8c/d. All the 
input data is latched by Z12. 
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Figure 9-6. Schematic for 8- track storage system. 
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Figure 9- 7. Schematic of tape player modification. 
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An 8-Track Mass Storage System 



Listing 9-4. 8- track load and save cartridge system. 



7000 

7000 
7000 
7000 
7000 
0060 

7000 0A 

7001 00 
0001 
0055 
0001 
0002 
0004 
0008 
0010 
0020 
0040 

0002 
0004 
0008 

8§ 1 20° 

0040 
0080 

7002 00 



7003 0E55 
7005 3E10 



10 CLS : HEM • THIS PROGRAM PRINTS CURRENT B-TRACK DRIVE STATUS 
20 OUT85,16 : REM * START B-TRACK DRIVE BY SETTING OUTPUT BIT 4 
30 PRINT90,"DATA 1: DATA 2:"; : HEM • L & H TRACKS 

40 PRINTS1 28, "TRACK NO.:"; : REM • CURRENT HEAD POSITION PROMPT 
50 A=INP(B5) : REM * GET DATA FROM 8-TRACK DRIVE AT PORT 55 HEX 
SO PRINTe66,(A AND 1281/128; : REM * TEST FOR HIGH DATA BIT 7 
70 PRINTe86,(A AND 1 ) ; : REM • TEST FOR HIGH DATA BIT & PRINT 
80 B=(A AND 120) : REM • 120 = 78HEX = 01111000 TRACK CONDITION 
90 IFB=112THENPRINTei40,"1"; : HEM • 01110000 = LO BIT 3 « TK1 
10D IFB=104THENPRINT«140,"2"; : REM • 01101000 » LOW BIT 4 =TK2 
110 IFB=88THENPRINTei40,"3"; : REM * 01011000 = LOW BIT 5 = TK3 
120 IFB=5BTHENPRINTei40,"4"; : REM • 00111000 ■ LOW BIT 6 ■ TK4 
130 IF[A AND 4J=4 THEN PRINT « 256, "SPLICE DETECTED"; : G0T0190 
140 IFCA AND 21=2 THEN PRINT 6 320, "CARTRIDGE IS IN " ELSE 

PRINT « 320, "INSERT 'CARTRIDGE "; 
150 = RND1120) : REM • RANDOM TRACK SWITCH FOR TESTING ONLY 
160 IF B=Q THEN OUT 85, BO ELSE 30 : REM • SWITCH TRACKS HERE 
170 FOR N = 1 TO 100 : NEXT : OUT 85, 16 : REM • RESUME NORMAL 
160 G0T030 : REM » RANDOM TRACK SWITCH COMPLETE; BACK TO START 
190 OUTB5.0 : A$=INKEY$ : IFA$=""THEN190 : REM * OFF, THEN TEST 
200 0UT85.16 : G0T030 : REM • TURN 8ACK ON WHEN ANY KEY PRESSED 
10 0UT254.2 : REM • HIGH-SPEED SELECT FOR TESTING PURPOSES ONLY 
20 CLS : REM * THIS ROUTINE CHECKS TOTAL CURRENT 8-TRACK STATUS 
30 0=148 : 0UT85,16 : REM * SET Q VALUE AND TURN ON TAPE DRIVE 
40 A=INP[85) : REM * GET CURRENT STATUS OF TAPE DRIVE FROM PORT 
50 B=(A AND 1281/128 : REM * GET VALUE AT DATA TRACK 1 (BIT 7) 
REM • GET VALUE AT TRACK POSN 4 [BIT 6) 
REM • GET VALUE AT TRACK POSN 3 (BIT 5] 
REM • GET VALUE AT TRACK POSN 2 I BIT 4) 
REM * GET VALUE AT TRACK POSN 1 [BIT 3) 
REM • GET VALUE OF SPLICE CONDITION (8IT 2) 



60 C=(A AND 64J/64 
70 D=(A AND 321/32 
80 E=(A AND 161/16 
90 F=[A AND BJ/B 
1D0 G=(A AND 41/4 



110 IF G=1 THEN OUT 85,0 : GOSUB 220 : REM • TURN OFF IF SPLICE 
120 H=(A AND 21/2 : REM • GET VALUE IF CARTRIDGE IS IN (BIT 11 
130 I=A AND 1 : REM * GET VALUE AT DATA TRACK POSN TWO (BIT 01 



140 PRINTea,"D7 D6 D5 D6 D3 D2 D1 DO" 
150 PRINT«Q+64,B;C;D;E;F;GjH;I : REM 



: REM » PRINT DATA HEAD 
PRINT VALUES CALCULATED 



160 PHI NTS [0+1 92) ,"D 

170 PRINTS I Q+256) ,"A 

180 PRINT#(Q+3201,"T 

190 PRINT«(Q+384),"A 

200 PRINT«[Q+448],"1 

210 G0T040 : REM • AND REPEAT THE PROCESS AS THE TAPE CONTINUES 

220 OUT 255,255 : OUT 255, : REH * A LITTLE SCREEN SHAKING 

230 A$=INKEY$ : IF A$="" THEN 220 : REM * TEST, LOOP IF NO CHAR 

240 0UTB5.24 : RETURN : REM • TAPE BACK ON, START PROCESS OVER 



T 


T 


T 


T 


S 


c 


D "; 


: REM * 


PRINT SOME 


R 


R 


R 


R 


P 


A 


A"; 


REM • 


PRETTY 


K 


K 


K 


K 


L 


R 


T"J 


REM * 


WORDS 


1 


t 


1 


* 


C 


T 


A"; 


REM • 


FOLLOW 


4 


3 


2 


1 


t 


N 


0"; 


REM * 


STATUS . 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
0D230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 , 
00370 RDBYTE 
00380 WRBYTE 
00390 LEADER 
00400 LEADRD 
00410 DELAY 
00420 HOWMNY 
00430 VERFLG 
00440 VERFON 
00450 PORT 
00460 WRITEN 
00470 WRITEA 
00480 WRITEB 
00490 RESSPL 
00500 START 
00510 FSTFWD 
00520 CHANGE 
00530 READA 
00540 CARTIN 
00550 SPLICE 
00560 TRACKO 
00570 TRACK1 
00580 TRACK2 
00590 TRACKS 
00600 READB 
00610 STATUS 
00620 



SHORT 8-TRACK OPERATING SYSTEM FOR CONVERTED 8-TRACK 
TAPE DECK. FORMAT: 

ON, FAST FORWARD, FIND SPLICE, WRITE ENABLE, WRITE 
256 BYTES OF DIRECTORY ENTRY, LOOP UNTIL 10 ENTRIES ARE 
WRITTEN OR NUMBER TRANSFERRED FROM BASIC IS ACHIEVED. 
FILL OUT TRACK WITH FF'S, VERIFY WRITE (IF VERIFY FLAG 
IS ON), FIND SPLICE, CHANGE TRACKS, REPEAT PRyyESS FOR 
ALL FOUR TRACKS. 

DIRECTORY READ AT HIGH SPEED. ENTRIES ENTERED AT LOW 
SPEED IN 256-BYTE PACKETS. EACH PACKET HAS A NUMBER 
WHICH IS STORED IN THE DIRECTORY. NO DEFAULT ON TRACK 
OR DIRECTORY ENTRY IS ALLOWED. DIRECTORY ENTRY #0 IS 
RESERVED FOR FREE PACKETS ON EACH TRACK AND SECTOR. 
*** NOTE: THIS LISTING IS NOT A COMPLETE OPERATING 
SYSTEM. IT CONTAINS A SAMPLE DIRECTORY FORMATTING AREA 
AND SAMPLE HIGH-SPEED TAPE READ/WRITE ROUTINES. A FULL 
8-TRACK OPERATING SYSTEM IS AVAILABLE; WRITE TO: 
MSB ELECTRONICS. MR#1 DRAWER 766, BARRE, VERMONT 05641 
OR DETAILS. THE INFORMATION PRESENTED IN THIS LISTING 
IS FOR DEMONSTRATION, ALTHOUGH IT MAY BE ORGANIZED, 
TOGETHER WITH OTHER STANDARD SAVE/LOAD PARAMETERS, INTO 
A FULL OPERATING SYSTEM. «•» 



00630 
00640 
00650 
00660 
00670 
00680 , 
00690 AAAAAA 
00700 



ORG 7000H 

EOjj $ . . ***** REASSIGN TO READ BYTE 

EQU $ ; »**** REASSIGN TO WRITE BYTE 

EQU S ; »**•» REASSIGN TO LEADER WRITE 

EQU * ; ***" REASSIGN TO LEADER READ 

EQU 0060H ; DELAY VALUE IN ROM 

DEF8 10D ; 10 UNLESS BASIC XFER 

DEFB OOH ; TRANSFERRED FROM BASIC 

EQU 01 H ; STATUS REQUIRED BY TOS 

EQU 55H ; DEFINED AT 85 DECIMAL 

EQU 01 H ; DIO = HIGH FOR WR ENABL 

EQU 02H ; DI1 = HI/LO FOR WRITE A 

EQU 04H ; DI2 = HI/LO FOR WRITE B 

EQU 08H ; DI3 ■ HI TO RESET SPLCE 

EQU 1 0H ; DI4 = HIGH FOR MOTOR ON 

EQU 20H ; 015 = HIGH FOR FAST FWD 

EQU 40H ; DI6 = HIGH TO CHNGE TRK 

EQU 01 H ; DQO GOES HI/LO DATA A 

EQU 02H ; DQ1 GOES HIGH AT CARTIN 

EQU D4H ; DQ2 GOES HIGH AT SPLICE 

EQU 08H ; DQ3 GOES HIGH AT TRK 

EQU 1 0H ; DQ4 GOES HIGH A TRK 1 

EQU 20H ; DQ5 GOES HIGH AT TRK 2 

EQU 40H ; DQ6 GOES HIGH AT TRK 3 

EQU 80H ; DQ7 GOES HI/LO DATA B 

DEFB OOH ; COMPOSITE OF ABOVE 

USE CUSTOM INTERPRETER 

ttttttttttttttttttitttttttttHnttttttttttttttttttttttt 
START 8-TRACK DECK MOTOR RUNNING [GIVE IT ENOUGH TIME) 

ttttfttttttfttttttttttttttttlttttttttlttttttttttttttttttttt 



BASIC PATCH HERE 



LD C.PORT ; START VALUE 

LD A, START ; BITS SET TO START 

Listing Continued . 



Figure 9- 8 presents the optional decoding of 
a ROM to contain the 8-track operating system. 
Notice that the decoding of the addresses is 
incomplete, so that data from 37C0 to 37FF must 
not be entered into the ROM to avoid bus 
conflict. The ROM should remain in its erased 
(all one's) condition in that memory area. 

Listing 9-4 is an operating system for the 
8-track storage system. It is made up of four 
major sections: 

1. Initialization. Patching the operating 
system into the BASIC interpreter. 

2. Formatting. The directory is set up past 
the splice on track zero in fast-forward 
mode. Each track is then written with 
program #1 headers. Because the tape is 
sequential, this is not a true disk-style 
directory. Instead, the directory stores the 
order and track number for each program, so 
that the correct track may be searched at 
high speed for its leader. 

3. Load Module. This accepts the 
command, checks for correct syntax and 
program type, activates the tape deck and 
searches for the program. 

4. Save Module. This module also accepts 
the command, checks syntax and program 
type, and writes the program to tape. The 
directory is updated. 

The most interesting aspect of the software is 
the method used for recording the data. After a 
start level, a low is written to tape. Each 
subsequent bit changes the level either once (a 
zero) or twice (a one). Clock bits are not used in 
this scheme. 

The operating system presented here is very 
basic, allowing only the elementary program save 
and load functions. However, data of all types 
may be stored in the system with additions to the 
software via additional commands. 

Several problems may initially be encountered 
in using this system: 

1. System does not respond. Make sure 
power is on; check for power to track lights. 
One should be lit. Find a cartridge which 
does not have its foil splice visible, insert the 
cartridge, switch to track 1 and PRINT INP 
(170). The value returned (in binary) should 
be xOOlOOOx. The x's are either one or zero, 
depending on the status of the data read 
outputs. Remove the cartridge. The value 
will change to xlOlOOOx. Switch to track 2, 
and replace the cartridge. Now it should 
read xOOOlOOx. 
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Continued Listing 



7007 FB20 

7009 320270 
700C 06FF 
700E ED79 

7010 10FC 



7012 1600 
7014 ED78 

7016 BA 

7017 280D 
7019 3E40 
701 B 2A0270 
701 E B4 
701F 320270 
7022 ED79 
7024 1BEE 



7026 ED78 
7028 E604 
702A FE04 
702C 20F8 
702E ED7B 
7030 E604 
7032 FE04 
7034 28FB 
7036 010010 
7039 CD6000 



703C CD0070 



m If 0070 

7043 06FF 
7045 CD0070 

7048 F5 

7049 ED78 
704B E604 
7040 FE04 
704F 2802 
7051 10F2 

7053 F1 

7054 3C 

7055 BE 

7056 30EB 



7058 3EFF 
7D5A CD0070 
705D ED78 
70 5F E604 
7061 FE04 
7063 20F3 



7065 14 

7066 7A 

7067 FE04 
7069 2B19 



7D6B 3E40 
7060 2AD270 

7070 B4 

7071 ED79 
7073 3E40 

7075 2F 

7076 2A0270 

7079 A4 
707A 010002 
7070 CD6000 

7080 ED79 
7082 18A2 



7084 3A0170 
7087 FE01 
7089 2036 



708B 1600 
708D ED7B 
708F BA 
7090 2819 
7092 3E40 
7094 2A0270 



00710 
00720 
00730 
00740 GOING 
00750 



00760 

00770 

00780 

00790 

00800 

00B10 

00820 L00P1 

00830 

00840 

OD850 

00860 

00B70 

00880 

00890 

00900 

00910 

00920 

00930 

00940 

00950 

00960 JUMP1 

00970 

OUSBU 

00990 

01000 JUMP1A 

01010 

01020 
01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
01110 
01120 
01130 
01140 
01150 
01160 

BUSS 

01190 



l 

OR 

LD 

LD 

OUT 

DJNZ 



FSTFWD 
(STATUS) ,A 

GOING 



GET INTO HIGH GEAR 
PUT IT INTO PLACE 
GET LONG LOOPS 
START 8 TRACK 
MANY TIMES FOR SURE 



f##f Iff #ff#####ff#*####fff#f#f##ffff####fff####f ##(#### 

MOVE TO TRACK ZERO, CHECKING STATUS OF TRACK EACH TIME 

fff######*##############fff#fff#####fffffff#fffff#ff#ff 



LD 

IN 

CP 

JR 

LD 

LD 

OR 

LD 

OUT 

JR 



w 



C] 



A, 

D 

Z.JUMP1 

A. CHANGE 

HL, [STATUS] 

H 

(STATUS) ,A 

(C),A 

L00P1 



TRACK VALUE TO CHECK 
CHECK TRACK VALUE 
AGAINST VALUE WANTED 
GO IF TRACK ■ 
TRACK CHANGE VALUE 
GET CURRENT STATUS 
CHECK PREVIOUS INFO 
AND PUT INTO PLACE 
CHANGE TRACK VALUE 
GO BACK UNTIL TRK = 



f#fffffffffffffffffffffffffff##f#fffffffffff##ff###ff#f 



IN 

AND 

LH 

JR 

IN 

AND 

CP 

JR 

LD 

CALL 



A x' c l 

SPLICE 

SPLICE 

NZ.JUMP1 

A,(C) 

SPLICE 

SPLICE 

Z.JUMP1A 

BC.1000H 

DELAY 



GET VALUE FROM PORT 
CLEAR ALL OTHER VALUES 
CHECK IF SPLICE DET'D 
BACK UNTIL FOUND 
GET VALUE FROM PORT 
CLEAR ALL OTHER VALUES 
CHECK IF STILL SPLICE 
BACK UNTIL SPLICE OVER 
GET DELAY VALUE 
DELAY TILL GOOD TAPE 



###f######ffff#f######f#f#########f #############*###### 
WRITE LEADER (NOTE: LEADER WRITE ROUTINE NOT INCLUDED) 



LEADER 



WRITE LEADER 



f##f#f##f#f#f#f#f*#fffffffffffff#f«ff #f#ffff######f#### 

FORMAT DIRECTORY (NOTE: THIS METHOD IS FOR EXAMPLE) 

############*###############fffff#ff#####fffffff#ff#ff# 



fWii 



s? 



LD0P3 



LTJr HL.HOWMNY I HO^Y^. 

LD B.OFFH ; 256 BYTES TO WRITE 

01200 L00P2 CALL WRBYTE ; WRITE THEM IN PLACE 

01210 PUSH AF ; SAVE ACCUM TEMPORARILY 

01220 IN A.IC) ; GET VALUE FROM DEVICE 

01230 AND SPLICE ; CLEAR ALL OTHER VALUES 

01240 CP SPLICE ; SEE IF SPLICE HIT 

01250 JR Z.JMPX ; GO IF SPLICE IS HIT 

01260 DJNZ L00P2 ; ELSE ON TO NEXT BYTE 

01270 JMPX POP AF i RESTORE ENTRY VALUE 

01280 INC A J UP TO NEXT ENTRY 

CP (HL) ; LAST ENTRY COMPLETED? 

JR NC,L00P3 ; OUT IF NOT DONE 

ffffffffff#ffffff###fff##fffff#fff#ffffftff#fffff*#f*f# 

FILL OUT TRACK WITH A SINGLE VALUE (AGAIN. OPTIONAL) 

fff#f##f##f#f#f##### 



L0OP4 



01290 

01300 

01310 

01320 

01330 

01340 

01350 

01360 

01370 

01380 

D1390 

01400 

01410 

01420 

0143D 

01440 

01450 

01460 

01470 

01480 

01490 

01500 

01510 

01520 

01530 

01540 

01550 

01 560 

01570 

D1580 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01680 

01690 

01700 

01710 

01720 

01730 JUMP2 

01740 

01750 

01760 

01770 

01780 

01790 

01800 ; 

01B10 

01820 JUMP4 

01830 

01840 

01850 

01860 



#f##fff########f#########lff *#!##### 



LD 

CALL 
IN 
AND 

CP 
JR 



A.OFFH 

tw 

SPLICE 
SPLICE 
NZ , L00P4 



WHEN DONE GET ALL FF'S 
WRITE FF BYTE TO TAPE 
CHECK CONTENTS OF PORT 
MASK OUT OTHER BITS 
CHECK IF TO SPLICE 
IF NOT KEEP WRITING 



##f#####f###########f*#*#*#lfff###ffff##l#ffffffffffff# 
GET NEXT TRACK VALUE AND GET TRACK FORMATTING READY 

####*#########*#######*#######f###f#*#f###########fffff 



INC 
LD 
CP 
JR 



D 

A,D 
4 
Z.JUMP2 



GET NEXT TRACK VALUE 
CHECK CURRENT VALUE 
IS IT FOURTH TRACK? 
IF NOT THEN BACK 



####################################################### 
FORMAT NEXT TRACK, AND CONTINUE UNTIL PROCESS COMPLETE 

####f##f ######### J##i>####f*f############*######*#####ff 



LD 

LD 

OR 

OUT 

LD 

CPL 

LD 

AND 

LD 

CALL 

OUT 

JR 



A. CHANGE 

HL, (STATUS) 

H 

(C),A 

A, CHANGE 

HL, (STATUS) 
H 

BC.200H 
DELAY 

icT7a 

JUMP1 



GET CHANGE TRACK VALUE 
GET CURRENT STATUS 
STATUS PLUS CHANGE 
AND CHANGE THE TRACK 
GET CHANGE TRACK AGAIN 
SWITCH THE BITS 
GET THE STATUS 
STATUS PLUS CHANGE 
GET DELAY VALUE 
AND INVOKE THE DELAY 
AND TURN IT OFF 
AND GO BACK FOR MORE 



############*#####f##l##########*###ff !################ 
CHECK IF VERIFY FLAG IS ON (NOTE: ADD AS BASIC COMMAND) 

f#########f###*#############l###ff#ff ##############?### 



LD 
CP 
JR 



A.IVERFLG) 

VERFON 

NZ.JUMP3 



STATUS OF VERIFY FLAG 

SEE IF FLAG IS ON 

IF NOT THEN SKIP PAST 



fffffffffff fff f f##fff#f#fff#f#f#«###fffffff#f##ffff**ff 

MOVE TO THE FIRST TRACK, CHECK EACH AS IT PROGRESSES 
fff f#fff###f###ffff#*#ff#f########f##ff##ffft###f ###*## 



LD 
IN 
CP 
JR 
LD 
LD 



a!(' 



a;io 

D 

Z.JUMP5 
A. CHANGE 
HL, (STATUS) 



ST COUNTER TO ZERO 
GET STATUS FROM DECK 
CHECK AGAINST TRK 
IF. AT ZERO, THEN GO 
ELSE BEGIN TO CHANGE 
GET VALUE FROM STATUS 
Listing Continued . . 



2. Tracks do not switch. Check wiring to 
the solenoid, and that the 75452 is wired 
correctly. Listen to hear if the solenoid 
attempts to react (a light click or start). 
Remove the 75452 from its socket and short 
the free lead of the solenoid to ground. It 
should switch. Replace the 75452 if 
necessary. 



3. Programs do not load. If programs do not 
load at all, check the cartridge on an audio 
deck to see if something has been written. If 
not, go on to #4 below. If so, listen for 
occasional changes in pitch as the machine 
switches from fast forward to normal. 
Lengthen the speed change wait period in 
the program if you can hear the pitch slide 
as it restarts at a new level. If a loading 
message is displayed, but an error is 
detected, try to read from another track. 
Tracks la and 4b are at the edge of the tape, 
and lower-quality tapes may drop out 
occasionally in this area. The head may be 
badly misaligned and not make good contact 
with the tape. This can be heard as shifting 
or slewing in the sound. Adjust the Phillips 
alignment screw on the head to match a 
prerecorded commercial tape of good 
quality. 



4. Programs do not save. Begin the 
program-saving process, and place the signal 
lead of a small amp against one lead of the 
recording head. If the signal is present, the 
program should be saving. If not, check the 
wiring of the buffer IC's, which may not be 
letting the signal through. Also check that 
the software is entered correctly, and that a 
signal is actually being sent to the device 
(correct connection of the write line, and 
proper wiring of the address decoding and 
data latch). If the motor turns on and 
switches tracks properly, the signal is 
probably being held up by incorrectly wired 
buffers to the recording head. 

5. Motor speed does not change. Make sure 
that the third lead from the motor is being 
switched to ground, not positive voltage. 
This lead reacts best when switched below 
ground, and ground potential is its minimum 
position. If you have substituted another 
solid-state switch for the one shown, make 
sure it goes to full ground potential when 
switched in place. 
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Chapter 9 



Construction and Checkout 




Craig playback deck disassembled. Front panel, main frame 
and feet are maintained, but switch panel, playback electronics, 
wires, and buttons are discarded Front buttons may be kept for 
appearance. 

Continued Listing 



7097 B4 

7098 ED79 
709A 3E40 
709C 2F 
7D9D 2A0270 
70A0 A4 
70A1 010002 
70A4 COEO00 
70A7 ED79 
70A9 1BE2 



70AB 1E00 
70AD 06FF 
7GAF C0007Q 
70B2 CD0070 
70B5 BB 
70B6 202B 
70B8 10FB 
70BA 1C 
70BB 3A0070 
70BE BB 
70 BF 20 EC 



70C1 AF 
70C2 320270 
70C5 ED79 



70C7 210070 
70CA C0A728 
70CD C37B1D 
7000 46 
70E3 21EC70 
70E6 CDA728 
70E9 C3CC0B 
70 EC 46 



01870 
01880 
01890 
01900 
01910 
01920 
0193D 
01940 
01950 
01960 
01970 
01980 
01990 
02000 
02010 
02020 
02030 
02040 
02050 
02060 
02070 
02080 
02090 
02100 
02110 
02120 
02130 
02140 
02150 
02160 
02170 
02180 
02190 
02200 
02210 
02220 
0223D 
02240 
02250 
02260 
02270 
02280 
02290 
02300 
D2310 
023 20 
D2330 
02340 
02350 
02360 
02370 
02380 



OH 

OUT 

LD 

CPL 

LD 

AND 

LD 

CALL 

OUT 

JR 



H 

(C),A 
A, CHANGE 

HL, (STATUS) 

H 

BC.200H 

DELAY 

(C),A 

JUMP4 



AND CHECK STATUS VAL 
AND SEND OUT CHANGE 
GET VALUE AGAIN 
REVERSE THE BITS 
GET VALUE FROM STATUS 
GET VALUE FROM STATUS 
GET DELAY VALUE 
CALL DELAY IN ROM 
AND SEND OUT CHANGE 
AND GO DO THE REST 



##########«###f##f####f #########################*###### 

VERIFY THE TAPE FORMATTING AND QUALITY IF FUG IS ON 



JUMP5 
L00P7 



LOOPB 



LD 

LD 

CALL 

CALL 

CP 

JR 

DJNZ 

INC 

LD 

CP 

JR 



E,0 

B.OFFH 

LEADRD 

RDBYTE 

E 

NZ.VERERR 

L00P6 

E 

A,(H0WMNY) 

NZ,L00P7 



PACKET NUMBER TO START 
BYTE TO VERIFY WITH 
GET SYNC AND READ LEADR 
BEGIN READING THE BYTES 
AND CHECK FORMAT INFO 
IF NOT CORRECT. ERROR 
AND GO BACK UNTIL DONE 
GO TO NEXT PACKET 
CHECK IF FORMAT DONE 
BY GETTING PACKET # 
BACK IF NOT DONE 



. ttttimt*tttHtttttttt*ttttttttitHUt*t*ntHttittttttt 

; STOP THE TAPE MACHINE AND CLEAR OUT ALL STATUS INFO 
MHttttttti§tttittitiitttt*ttittiHHttttt*iHiHtttti 



JUMP3 XOR A 

LD (STATUS), A 

CUT (C),A 



; CLEAR ACCUM TO ZERO 
; PUT IN STATUS LOCATION 
; AND SEND IT OUT PORT 



. tttttlnnnnnttttt§§ttttttmit*tltttt§t0tttttttit*ttttttt 

; GET AND DISPLAY FORMAT COMPLETE MESSAGE [OR ERROR MSG) 
. tittttipttttiitttiittltltlttlltltlttHitltttttlttlttttt 

LD HL.MESG01 ; GET THE OKAY MESSAGE 

CALL 28A7H ; LEVEL II DISPLAY ROUT. 

JP 1D78H ; BACK TO INTERPRETER 

DEFM 'FORMATTING COMPLETE' 

LD HL.MESG02 ; VERIFY ERROR MESSAGE 

CALL 28A7H ; DISPLAY SUBROUTINE 

JP 06CCH ; BASIC COMMAND LEVEL 

DEFM 'FORMAT ERROR' 



MESG01 
VERERR 



MESG02 

; MHHfftttttttiftftitttffifftttffftffftftfffffffffffffi 

; THESE ROUTINES MAY BE CALLED WITH THE /LOAD COMMANDS OR 
; THE /SAVE COMMANDS, AS WELL AS THE FORMATTING ABOVE. 
; NOTE: THESE ROUTINES USE AN EXCLUSIVE-OR METHOD OF 

Listing Continued . . . 



Construction and Checkout 

Since I recommend wire-wrapping the projects 
in this book, there are some different 
considerations when wrapping all the resistors 
and capacitors necessary for this project. 
Wire-wrapping is done best when there are 
sharp, square pins on which to wrap; since 
resistors and capacitors have round leads, it is 
best to insert these parts into sockets. Not only 
will the wrapping be more firmly attached, but 
the parts will not fall out when you are turning 
the board over during construction. 

Before beginning construction, note that the 
transformer installed in the Craig recorder is 
marginal; ideally, it should be replaced with a 12 
volt, 1.5 amp transformer of the type sold by 
Radio Shack. This will fit, though not 
comfortably, in the present transformer's 
location. The center tap is not used. 



Because there are mechanical and inductive 
parts in this device, a great deal of 
electromagnetic noise can be produced. Be sure, 
then, to do the following: 

1. Use bypass capacitors (.01 mF or so) 
between power and ground on every 
integrated circuit. 

2. Use bypass capacitors (.01 mF) on the 
75452 peripheral driver chips as noted, as 
well as diodes (hobbyist lN914's are fine) 
across the three relay coils. Leave the 
diode already present on the track change 
solenoid. Don't skip these parts; they 
make the difference between a working 
system and a continuous return to 
MEMORY SIZE. 

3. Use a central grounding point for all wires 
on the circuit board, and another central 
point for all wires on the drive. Don't weave 
wires from one IC to another. 

4. The resistors at the inputs of the CMOS 
chips (the 80C96 and 80C98s) are vital for a 
reliable signal, and also prevent damage to 
the chips themselves. 

5. The wires leading to the recording head 
should be twisted or shielded to prevent 
picking up extraneous signals. Remember 
also that the connections of the top and 
bottom pairs of pins on the head should be 
the same. 



The Custom TRS-80 
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Construction and Checkout 



Continued Listing 

02390 

02400 

02410 

02420 

02430 

02440 

02450 . 

02460 BOTTOM 

02470 BASIC 

02480 : 

02490 ENTER 

02500 

02510 

02520 

02530 

02540 

02550 



RECORDING, WHICH WILL FUNCTION WITH A DIRECT DIGITAL 
RECORDING SITUATION SUCH AS THE 8-TRACK DEVICE. FOR 
FURTHER INFORMATION ON ITS OPERATION, ASK FOR THE 
OHIO SCIENTIFIC TAPE WAFER INTERFACE, SOLO BY MSB 
ELECTRONICS (ADDRESS ABOVE), AND EXAMINE THE CODE. 



40F9 
06CC 

70F8 F3 
70F9 2AF940 
70FC 3A3D40 
70FF E6FC 
7101 323D40 
7104 5F 



EQU 

EQU 

UI 
LD 
LD 
AND 

LD 
LD 



40F9H 
06CCH 



HL, (BOTTOM) 

A.I403DH) 

OFCH 

(403DH),A 

E,A 



BOTTOM OF BASIC PROGRAM 
RETURN TO READY MODE 

KILL THEM SUCKERS 
GET FIRST PROGRAM LOC'N 
VALUE IN THE MASK 
SET BIT TO ZERO 
PUT BACK INTO LATCH 
WILL BE USED A LOT 



7105 7E 

7106 57 

7107 0608 
7109 3E01 
71 OB B3 
71 OC D3FF 
71 OE CD4371 

7111 AF 

7112 B3 

7113 D3FF 



7115 0DE5 
7117 DDE1 
7119 DDE5 
71 1B DDE1 
71 1D 00 
711E 00 



71 1F CD4E71 

7122 AA 

7123 E601 

7125 F5 

7126 B3 

7127 D3FF 

7129 F1 
71 2A 2F 
71 2B E601 
7120 CD4E71 

7130 F5 

7131 B3 

7132 220000 

7135 00 

7136 D3FF 

7138 F1 

7139 CBOA 
713B 10E2 



7130 CD4E71 
7140 23 



7141 20C2 



7143 F5 

7144 C5 

7145 012800 



7148 CD6000 
7148 C1 
71 4C F1 
71 4D C9 

714E F5 
71 4F C5 
7150 010300 



7153 CD6000 

7156 C1 

7157 F1 

7158 C9 



70F8 

00000 TOTAL 

21490 TEXT 



Loop 



02560 NEXT 

02570 

02580 

D2590 

03600 

02610 

02620 

02630 

02640 

02850 

02660 

02670 

02680 

02690 

02700 

02710 

02720 

02730 

02740 

02750 

02760 

02770 

02780 

02790 

02800 

02810 

02820 

02830 

02840 

02850 

02860 

02870 

02880 

02890 

02900 

D2910 

02920 

02930 

02940 

02950 

02960 

02970 

02980 

02990 

03000 

03010 

03080 

03090 

03100 

03110 

03120 

03130 

03140 

03150 

03160 

03170 

03180 

03190 

03200 

03210 

03220 

03230 

03240 

03250 

03260 

03270 

03280 

03290 : 

03300 0ELAY1 

03310 

03320 

03330 

03340 

03350 

03360 

03370 

03380 

03390 

03400 

03410 

03420 : 

03430 DELAY2 

03440 



LD 

LD 

LD 

LD 

OR 

OUT 

CALL 

XOR 

OR 

OUT 



A,(HL) 
D,A 

B,8 

(OFFH),A 

DELAY1 

A 

E 

(OFFH) ,A 



SPECIAL TEST [EXAMPLE) 
THIS IS THE BIG BUMPER 
NUMBER OF BITS TO WRITE 
THIS IS THE START BIT 
GET PROPER LATCH MASK 
WRITE OUT START LEVEL 
WRITE A START DELAY 
SET UP A WITH I/O BIT 
GET PROPER LATCH MASK 
WRITE OUT STARTING EDGE 



t*tttt§ttttttttftttitttt*ttttttttttttttHtttttttttH*tt 

ADDING 66 T-STATES HERE TO TOTAL 95 US 



PUSH 
POP 

push 

POP 

MOP 
NOP 



IX 
IX 
IX 
IX 



15 T-STATES 

14 T-STATES 

15 T-STATES 
14 T-STATES 
4 T-STATES 
4 T-STATES 



THIS IS SET UP FOR 3300 BAUD 

TOTAL LOOP TIME PER BIT SHOULD BE 300 US 

TOTAL T-STATES FOR EACH BIT LOOP = 169 = 95 US 

TOTAL T-STATES FOR BIT DELAY LOOPS AT 0060 NOTED BELOW 



CALL 



DELAY2 



WRITE A NORMAL DELAY 



XOR 

AND 

PUSH 

OR 

OUT 



D 

1 

AF 

E 

(OFFH) ,A 



TEST THE FIRST BIT 
MASK OUT OTHER D BITS 
SAVE THE VALUE 
VALUE OF LATCH MASK 
WRITE IT 



POP 

CPL 

AND 

CALL 

PUSH 

OR 

LD 

NOP 

CUT 



"Af 

1 

DELAY 2 

AF 

E 

(0000) ,HL 

(OFFH) ,A 



ORlGiNAL VALUE BACK 
REVERSE THE BIT 
MASK OUT ALL BUT ONE 
WRITE A NORMAL DELAY 
SAVE THE PROPER BIT 
AGAIN GET THE MASK 
NEED DELAY TIME 
BIT MORE DELAY TIME 
WRITE IT 



POP 
RRC 
DJNZ 



AF 

D 

LOOP 



; GET ORIGINAL BITS BACK 
; ORIENT TO NEXT BIT 
; WRITE OUT 8 BITS 



XOR 
OR 
OUT 
CALL 

INC 



A 
E 

(OFFH) ,A 
DELAY 2 

HL 



CLEAR ACC. TO ZERO 
GET MASK FROM 403D 
SEND OUT ZERO BIT 
SPACE OUT LAST BIT TOO 

GET NEXT MEMORY LOC'N 



PUT TESTING FOR MEMTOP HERE 



LD 
CP 
JR 
JP 

PUSH 
PUSH 
LD 



A.H 
40H 

NZ.NEXT 
06 CC 

AF 
BC 
BC,28H 



CURRENT MEMORY STATUS 
END? (EXAMPLE ONLYI I) 
GO BACK IF NOT DONE 
READY [USE RETURN I) 

SAVE AF REGISTERS 
SAVE BC REGISTERS 
GET DELAY VALUE 



{ltrt»titlHitlUttt»HI>fUttttttf,tt t ,,tttt<HttttHt» 

LINE ABOVE COMPLETES A TOTAL 1000 US DELAY LOOP 
t*t*tttttttltl§tt**tllttttt*»ltlHHHt*HHt*tHHtltt1Hltt 



03450 

03460 

03470 

03480 

03490 

03500 

03510 

03520 

03530 

03540 

03550 

03560 

03570 
ERRORS 
AREA BYTES LEFT 



CALL 

POP 

POP 

RET 

PUSH 
PUSH 
LD 



0060H 
BC 

AF 



AF 
BC 
BC.03H 



MAKE A DELAY 
RESTORE BC REGISTERS 
RESTORE AF REGISTERS 
BACK TO MAIN ROUTINE 

SAVE AF REGISTERS 
SAVE BC REGISTERS 
GET SHORTER DELAY VALUE 



f#####f#################f##ff#ff##fff####f###ff##f####f 

LINE ABOVE COMPLETES AT TOTAL 205 US DELAY LOOP 



CALL 
POP 

POP 
RET 



0D60H 
BC 

AF 



; MAKE A DELAY 
; RESTORE BC REGISTERS 
; RESTORE AF REGISTERS 
; BACK TO MAIN ROUTINE 



END ENTER 



Position sockets as close together as possible 
so the final board will fit into the tape drive's 
case. Fill the board with sockets and parts, and 
test its size before beginning the wire-wrapping. 

Wire-wrap all connections completely before 
installing the 80C96 and 80C98 ICs. Because 
they are static-sensitive CMOS, they can be 
damaged by improper handling or application of 
power to partly-connected ICs. 

When construction is complete, install the 
ICs, connect the unit to the TRS-80, and apply 
power. 




Detail view of Craig mechanics. Track change mechanism is 
operated by a spinning cog on the drive capstan (lower right). 
Four track change lights are illuminated by switch contacts to the 
rear of the playback head. 



AAAAAA 


7003 


00690 








BASIC 


06CC 


02470 








BOTTOM 


40F9 


02460 


02500 






CARTIN 


0002 


00540 








CHANGE 


0040 


00520 


0D850 


01560 01600 01850 01890 




DELAY 


0060 


00410 


01050 


01650 01940 




DELAY1 


7143 


03300 


D2620 






DELAY2 


71 4E 


03430 


02860 


02970 03170 




ENTER 


70FB 


02490 


D3570 






FSTFWD 


0020 


00510 


00710 






GOING 


700E 


00740 


0D750 






HOWMNY 


7000 


00420 


01170 


02100 




JMPX 


7053 


01270 


01250 






JUMP1 


7026 


00960 


00840 


00990 01670 




JUMP1A 


70 2E 


01000 


01030 






JUMP2 


7084 


01730 


01500 






JUMP3 


70C1 


02180 


01750 






JUMP4 


70BD 


01820 


01960 






JUMP5 


70AB 


02020 


01840 






L-Fm-D a 


82M8 






LOOP 


711F 


02860 


03120 






L00P1 


7014 


00820 


00900 






L00P2 


7045 


01200 


01260 






L00P3 


7043 


01190 


01300 






L00P4 


7058 


01360 


01410 






L00P6 


70B2 


02050 


02080 






L0OP7 


70AD 


02030 


02120 






MESG01 


70D0 


02290 


02260 






MESG02 


70 EC 


02330 


02300 






NEXT 


7105 


02560 


03270 






PORT 
RDBYTE 


0055 


00450 


00690 






7000 


00370 


02050 






READA 


0001 


00530 








READB 


0080 


00600 








RESSPL 


0008 


00490 








SPLICE 


0004 


00550 


00970 

01400 


00980 01010 01020 01230 01240 


01390 


START 


0010 


00500 


00700 






STATUS 


7002 


00610 


00720 
02190 


00B60 00880 01570 01620 01860 


01910 


TRACKO 


0008 


00560 








TRACK1 


0010 


00570 








TRACK2 


0020 


00580 








TRACKS 


0040 


00590 








VERERR 


70 E3 


02300 


02070 






VERFLG 


7001 


00430 


01730 






VERFON 


0001 


00440 


01740 






WRBYTE 


700D 


00380 


01200 


01370 




WRITEA 


0002 


00470 








WRITEB 


0004 


00480 








WRITEN 


0001 


00460 
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And Now It's Broken 

It is not inevitable that your TRS-80 will fail 
during your lifetime, but there's always that 
chance. And if it happens, there's no reason to 
truck the computer down to the nearby 
Cost-a-Buck repair center. Do it yourself. This 
chapter will present the most likely failures or 
dilemmas you may encounter with your TRS-80, 
including: 

Setting up a reliable, crash-free 
environment in a typically casual home. 

Curing memory crashes in the CPU or the 
expansion interface, and replacing failed 
memory. 

Solving the garbage-on-screen power-up 
failure. 

Discovering the many sources of mysterious 
program crashes and keyboard lockup, and 
how to cure them. 

Aligning your video display to cure images 
off-screen, tearing or jitter. 

How program bugs can look like hardware 
failures, and vice versa. 

'Routine' maintenance - the hidden cure for 

many failures. 

Handling the computer and its peripherals. 

Overview of difficulties in disk drivers, 
cables, cassette devices, printers, RS-232 
boards, and other add-ons. 



A New Keyboard Cable 

Virtually every modification to the TRS-80 
contains a warning like this: 'Carefully open the 
case, and carefully take out the unit then 
carefully spread it out. Work carefully so as 
not to bust the keyboard cable'. So what's with 
the cable that makes it so fragile? The 
connections to the computer boards seem 
secure, but if you look carefully at the cable 
itself, you will see that it is made up of flat 
copper bands inside an insulating strip. The 
bands themselves are strong, and the 
connections to the computer are strong. 

The problem occurs at the point where the 
copper bands are clamped to the connectors 
that attach to the circuit board. Hairline 
cracks develop in the copper bands, separating 
them almost invisibly from the connecting pins. 
The only evidence of these cracks comes when 
odd combinations of letters appear sporadically 
while you are typing. 

If you plan to open the machine more than a 
half dozen times, you should replace the 
conection, with a 20-wire multiconductor cable 
or very flexible single conductor phono 
cartridge wire. 

First, cut the present cable off with shears, 
cutting at the point where the copper bands 
meet the connectors. Now, with generous 
amounts of solder-wick, remove the 40 
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Replacing the keyboard cable: Solder-wick and flux cleaner are 
used to remove all traces of the old connection cable. 




Replacing the keyboard cable: A new flexible cable is attached to 
both boards. A removable cable and connector can be used, but 
the permanent flexible cable serves well enough once most 
modifications have been made. 



connectors on the keyboard and CPU board. 
Make sure all the copper is out of the holes, 
and clean what is surely to be a mess with flux 
remover, then buff the solder so new wires will 
slip easily through the holes. 

The new cable can be six inches long or more 
without affecting the operation of the unit. My 
own added keyboard, which is wired into place 
in the same manner as the original, has a 20 
foot cable and suffers no ill effects or program 
crashes. Cut and strip no more than one 

quarter inch of insulation off each end, and tin 
all 40 ends. 

Tinning is the process of running some hot 
solder onto the wire to prepare it for easy 
soldering to the board. The wire will remain 
the same diameter, the solder should not lump 
up, but will become smooth, hard and shiny 
with a solder coating. This will allow the wire 
to pass easily through the holes without 
random strands sticking out sideways and 
shorting against the neighboring connection. If 
the insulation creeps back from the heat, finish 
tinning all the ends and then clip them back to 
one quarter inch. 

Pass the multiconductor through all the 
holes in advance, and secure it temporarily 
with masking tape or other tape not affected by 
warmth. Getting all the wires through can be 
tricky, but accept the absurdity of the process 
in advance; outsiders tend to burst into 
laughter at the sight of a grown adult trying to 
thread 20 needles simultaneously, so if you 
can't take a joke, do this with the door locked. 

When all the wires are attached to either the 
keyboard or the CPU board (I recommend the 
keyboard first because it is lighter), check for 
shorts, then thread the cable through the other 
board. Solder, then look carefully for shorts 
before applying the power; both five volts and 
ground run through the cable, so be sure 
everything is well. 

Apply power. All characters should work 
properly, and no odd combinations of letters 
should be produced. If the power LED does 
not come on, either a connection was left off or 
you have a short. Power off immediately, and 
check again. If letters are missing, a connection 
was probably not made. If odd combinations of 
letters appear, you probably have a broken 
wire. If incorrect letters appear, you have 
switched wires. Once it's all working, you can 
ignore those 'carefully . . .' warnings and 
concentrate on the modifications to be made. 
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Home and 
Environments 



Small Business 



Computers are designed in laboratories, tested 
in laboratories, examined by engineers and run 
by programmers. There could hardly be a more 
unlikely manner of producing an appliance-type 
product like the TRS-80. When you unpack the 
home computer and plug it in, you begin a torture 
test unimagined by the professionals in their 
sleek, air conditioned factories. 

Below is a computer environment quick quiz; if 
you answer 'yes' to any question, your TRS could 
be in trouble. The more 'yesses', the more 
potentials for disaster: 

• Your computer and peripherals are 
plugged into extension cords or cube-taps. 

• A refrigerator, toaster, water pump, 
washer, dryer, or other large appliance is on 
the same fuse or breaker circuit as your 
computer. 

• You have an electric mixer, blender, or 
food processor which is used when the 
computer is used. 

• You have an electric drill, jigsaw, or table 
saw which is used when the computer is 
used. 

• Your computer table desk lamp is a 
push-on and hold fluorescent type. 

• You use your computer on or near a 
television set while the tv is turned on. 

• Your computer is used in the kitchen or 
shop, you or a family member smokes, or you 
heat with wood or coal. 

• You have fur-bearing animals in the house 
near your computer, especially cats. 

• Your power is supplied by a rural 
cooperative, or is generated by a local power 
company especially with low-head 
hydropower systems. 

• You live in an industrial area where heavy 
electrical equipment (winches, cranes) is 
used. 

• Your electrical thermostat is located near 
the computer. 

• Your home is especially dry, and you do 
not use a humidifier. 

• You live in a coastal area, or by a 
salt-water lake. 

• Your computer area is located near a 
railroad or by a highway traveled by heavy 
trucks. 



• You move your computer while it is on. 

Chances are you've got at least one check mark 
on the list above. Here are some solutions to 
these environmental problems: 

1. Plug your computer directly into a wall 
outlet, or use a commercial 'power strip'. 

2. Make sure that the computer is on a 
single-appliance circuit, even though it uses 
very little power. 

3. Brush-motor electrical appliances like 
mixers and drills create an enormous amount 
of electrical noise. Reach a compromise with 
the culinary artist or the shop craftsperson 
to use those tools at some other time, or at 
least far away from the computer. 

4. Use incandescent lamps, which send out 
virtually no electrical hash, and get rid of the 
fluorescent ones. Don't use a television for 

a computer table, because it creates heavy 
electromagnetic fields. And move the 
computer or the thermostat; there's a 
tremendous electrical noise jolt transmitted 
when that thermostat turns on. 

5. Keep smoke and grease of all kinds out of 
your computer's atmosphere, as well as 
animal (and people) hair. Tape and disk 
drives hate the stuff, and cables, connector, 
and keys build up greasy mudpiles because 
of them. 

6. If your power is unsteady because of an 
inept or unconcerned power company, or 
because local industry unexpectedly drains a 
large amount of power, you will have to 
install some sort of power regulator. Types 
such as Solatron, Mayday, and Topaz 
provide different qualities of regulation, at 
corresponding costs (see Appendix). 

7. Use a humidifier, or place pans of water 
on radiators or stoves if you house is 
especially dry in winter, because static 
electricity is quite powerful. If you live in a 
salt-air atmosphere, air-condition your 
computer area during warm, humid days. 
Salt air corrodes cables and connections. 

8. If railroads or trucks are nearby, cushion 
the computer. Vibration can cause noise in 
cables and especially the expansion box, and 
make disk reading and writing very 
failure-prone. Likewise, moving the 
computer (or even just pulling or straining 
the expansion or peripheral cables) can 
create bursts of electrical noise through the 
computer. Don't do it. Interestingly, even 
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pushing away a hard chair that vibrates on a 
linoleum or hardwood floor can cause disk 
read/write errors. And don't forget the 
dummy plug for CTR-41 tape recorders 
when saving programs! 

The home and small business environment is 
not often conducive to these suggestions, and 
some of them may not be necessary, depending 
on other factors. If you maintain your cables, 
edge card connectors, keyboards, etc., and keep 
your computer cushioned and seated on a 
conductive tabletop, you've gone a long way to 
increasing reliability. 

Furthermore, merely thinking of your 
micrcomputer in the same terms that used to be 
reserved for larger computers in the past 
(COMPUTER ROOM! NO SMOKING! . . . 
CAUTION! SENSITIVE ELECTRONIC 
EQUIPMENT! ... NO FOOD OR DRINK IN 
THIS ROOM!), then you have the right idea. 
Electronically, your TRS-80 can take a great deal 
of abuse and still function. But this abuse cannot 
take place while the computer is running. And 
that is the clue: treat your operating computer as 
if you were paying $50 an hour in time-sharing 
charges. 

When the Memory Crashes 

In early TRS-80's, memory crashes were the 
most prominent sort of failure. The type of 
memories used were the culprit, partly because of 
expansion box design problems, but especially 
because an unusual condition called the 'soft 
error' had not then been diagnosed. 

The 'soft error' was the tendency of a perfectly 
good program to crash with some error message 
when no such error was present. A simple 
CONTinue command would restore the system. 
These errors were caused by the internal 
structure of the memory chips themselves, 
which, because they are 'dynamic', use a peculiar 
and surprising principle for their operation. 

Memories maintain information. That is their 
job. 'Static' memories retain information so long 
as the power is applied to the computer. 
'Dynamic' memories, the type used in the 
TRS-80, retain their information for only a few 
thousandths of a second, requiring a electronic 
prodding, called refresh, to remember their data. 
They depend on their internal capacitance, 
acting much like a leaky tire. 

In the early days, this odd way of maintaining 
memory resulted in occasional erratic behavior, 
sometimes because the chip itself was flukey, and 
sometimes because normal low-level radioactive 



alpha-decay, present right on the base of the 
chip, could knock a memory bit from one state to 
another. This radioactivity is so delicate that a 
single sheet of paper can stop it. So this memory 
failure would occur only when the radioactive 
alpha particle actually struck a junction, and 
only when that junction was struck at precisely 
the right billionth of a second. Newer memories 
use a 'cool' base which does not emit alpha 
radioactivity, and so this rather bizarre problem 
has finally disappeared. 

But memory crashes still occur, and they come in 
a few major forms: 

Temporary crashes due to electrical noise in 

the vicinity of the computer. 

Temporary crashes in the expansion 
interface due to a badly attached or 
otherwise noisy set of refresh lines. 

Temporary crashes due to improperly 
seated or corroding memory chips. 

Permanent crashes due to bad memory 

chips. 

Repairable crashes due to a damage to one 

of the three lines responsible for memory 

refresh. 

Electrical storms. I'll digress just a 
moment on this one. During a summer 
meeting of the Vermont Computer Guild, an 
electrical storm approached rapidly. We 
began to engage in a sly but nervous game of 
electronic chicken, leaving our micros not 
only attached to the power, but running! 
Naturally, that was too much of an 
invitation to Mom Nature, who zapped our 
very power line with a basketful of 
megavolts. My TRS-80 kept working; 
another hung, but reset. An Apple winked 
and sighed, and its memory cleared. A KIM 
turned tail completely, taking with it video 
routines and all. And the expensive DEC 
PDP/ll was broiled, losing more than a 
handful of expensive chips. Moral: You 
know it. 

Also, there are crashes which appear to be 
memory crashes when they are in fact otherwise. 
Among these: 

A wayward program containing errors in 
PEEK or POKE statements, or machine 
language subroutines. 

A damaged CPU chip or blown buffer chip. 

A cracked circuit board trace, solder ball, or 
solder splash. 
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Cleaning the Edge Connectors 

The expansion connector on the back of the 
CPU, and the various ports around the 
expansion interface, were all manufactured 
using a solder coating instead of gold plating. 
Because solder is lead, and lead tends to 
corrode badly, these connections will inevitably 
get electrically noisy. 

Cleaning them is quite easy, and should be 
done, depending on your environment, from as 
often as weekly to a minimum of monthly. 

Turn the equipment off and remove all 
cables. Check the edges of the cables for 
internal bend pins, hairs, or other damage or 
obstructions. Next, remove the top and bottom 
of the keyboard and expansion interface cases; 
if you don't wish to go inside your computer, 
this process can still be done, although it is 



awkward. 

Using a new dollar bill, a piece of the finest 
grade of emery paper, or a fine talc buffing 
wheel, bring the contacts to a bright shine. 
Brush off any remaining particles, and spray 
with contact cleaner (sometimes called tv tuner 
cleaner). Repeat this for all the edge 
connectors, and reinstall the cables. 

If this process is repeated regularly, 
interconnect noise problems will be completely 
eliminated. However, if cables slide along the 
contacts when the computer is in use, noise 
may still be produced. To cure this, place no 
strain on the cables, and replace the keyboard 
expansion cable with a longer, more flexible 
unit. If your TRS-80 uses the buffered cable, 
instead of replacing it, merely add to it with 
one of the cable extenders sold by Exatron and 
others (see Appendix). 



There are two software tools which can be used 
to eke out memory problems: the memory test 
printed in Chapter 3 , and MEMORY SIZE? 
itself. Running the memory test will describe 
which memory locations and chips may be bad. 
When the MEMORY SIZE? question is 
answered with only a carriage return, a Level II 
subroutine begins testing each memory location 
until it finds a bad one; that final non-memory or 
bad memory location is found by typing: 

PRINT PEEK [165611 + 256 » PEEK 116562) + 2 




Photo 10-1. Power supply transistors. 



In a 16K machine, the value returned should 
be 32768. If it is less, then the value returned is 
a bad memory location. Since the MEMORY 
SIZE? test is simplistic, it will not identify all 
possible memory errors, and if you suspect one, 
run the memory test. 

If the bad memory location seems to move 
about, then perhaps it is not a true memory 
problem at all, but rather due to bad connections 
or electrical noise. Be sure noisy electrical 
equipment is not located near the computer. 
Clean cable and edge card connectors (see Box), 
and see if the problem recurs. If it does, open the 
case of your keyboard unit (and expansion box), 
and remove and reseat each memory chip. Look 
for corrosion, especially on newer chips without 
gold-plated leads. 

If the problem is still not cured, the difficulty 
may be in the power supply. The location to 
suspect first is the large transistor (Q 4 - see 
Photo 10-1 ), which is screwed down to the 
circuit board. Corrosion can build up between 
this transistor and the solder-plated circuit 
board. Loosen and remove the screws that attach 
the transistor, but do not attempt to remove the 
transistor itself. Slide fine emery paper - 
definitely not steel wool or sandpaper - face 
down between the transistor and the board, and 
clean out any corrosion. 

If a lockwasher was not used between the 
transistor and the board, insert one, and reinstall 
and tighten the screws. This should stabilize the 
power supply inside the case. 
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Using an Oscilloscope 

The oscilloscope is a very sophisticated tool, 
but in this book it is used for an elementary 
purpose: merely to see if a signal is 'there' or 
not, and if it looks pretty good. Almost all 
TRS-80 circuitry failures can be traced this 
way, and it requires no previous experience 
using an oscilloscope, and no special training in 
reading waveform timings. 

The height of an oscilloscope screen trace 
changes in proportion to the signal present at 
its input. To see this, plug in the scope, turn it 
on, and adjust the intensity until a flat line is 
visible in the center of the display. Attach its 
cables to the vertical input. Leaving the 
ground (black) wiring hanging, hold the signal 
(red) wire in one hand. The flat line displayed 
on the screen should go wild. 

Adjust the vertical calibration (or voltage 
range) until you can see the trace. Adjust the 
sweep, sweep vernier and synchronization 
controls until the trace stabilizes, and looks like 
this: 




Photo 10-3. Photo of sine wave. 

Adjust the vertical and horizontal centering 
until the trace is in the center of the screen. 
What you see is your own body acting as a kind 




of transformer, soaking up all the electrical 1 
signals from the wiring and equipment all 
around you. 

Now hold the black ground wire in your 
other hand. The wild trace should now flatten 
out considerably, as you become both signal 
and ground, essentially 'shorting out' the bulk 
of the signal received by the oscilloscope. 

Next, power down your TRS-80 and open it. 
Using clips or by soldering a wire temporarily 
into place, attach the black ground wire to the 
point shown in the photo below: 

Hold onto the red cable, and power-up the 
computer. Now find pin (?) of the Z-80 
microprocessor (Z40 on the circuit board), and 
hold the red probe to it. Adjust the screen so 
you can see all of the trace, and it consists of a 
regular series of pulses. 




Photo 10-5. 1.77 MHz clock pulses. 

What you are looking at is the actual 
1,774,000 pulse per second master clock of the 
TRS-80. All the signals you see throughout the 
computer should be of this quality - 
sharp-edged and clean. They will not have the 
same regularity, because different lines are 
turned on and off only as needed. But the 
signals should always be of the same crispness. 




Photo 1 0-4. Photo of TRS-80 ground point for scope. 



For practice, place the red probe at various 
points on the computer, being very careful not 
to short two points together with the tip of the 
probe. You will see the many kinds of signals 
present throughout the computer. If your 
computer has a problem, you will be looking for 
signal lines which have failed: they will be 
rounded, or angled instead of vertical, or will be 
much lower in level than the ones you see now. 
This is a clue to the area of the failure. 
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The next step is to switch the external black 
power supply box with a new one, because your 
present supply may have a damaged, highly 
resistive, or intermittent fuse wire. Later 
supplies can be opened to check this; there are 
screws under the feet. If the new supply works, 
have the old one repaired, or open it yourself and 
replace the fine fuse wire with a new one. 

Memory problems caused by damaged refresh 
lines are subtle, but can be discovered. Load a 
BASIC program, LIST it, and re-LIST it. If 
gradually the program shows changes, suspect 
that the refresh lines may be weak. To diagnose 
this job fully, you will need an oscilloscope. 

Photo 10-2 shows how cleanly a good signal is 
represented on the scope screen. Anything less 
than a sharp-edged, rectangular pulse should be 
suspect. Furthermore, a signal that is distinctly 
lower than others can be suspected. 




Photo 1 0-2. Digital scope photo. 

Aligning the Video 

Video jitter in most cases is due to incorrect 
settings of either the vertical or horizontal 
controls on the back of the monitor itself. To 
align these, enter the following short program: 

10 CLS 

20 FOR X = 15360 TO 16383 

30 POKE X.191 

40 NEXT 

50 GOTO SO 

Listing 10-1. Video centering routine. 

This will paint the screen white. Any bulging 
on either side of the screen can be cured by 
adjusting the horizontal control on the back of 
the monitor. Turn it until the bulging is reduced 
as much as possible. Instability or rolling is most 
easily cured by adjusting the vertical control on 
the back of the monitor. 'Zero' it in by making 
the screen first roll forward, then back, then 
forward, and back again until you have what feels 
like the central position of the control. 

Open the TRS-80, and set the program above 
in motion again. The horizontal and vertical 
positioning controls are located at the far right of 
the circuit board as shown in Photo 10-1. 
Adjust these until the image is properly centered, 
and drop a very small amount of glue or nail 



polish on the control's plastic handle to hold it in 
that position against the control's body. 

Any remaining instability in the screen display 
can usually be attributed to low voltage present 
on your house current line, or problems with the 
TRS-80 power supply (see above). 

Routine Maintenance 

Microcomputers like the TRS-80 are generally 
thought of as maintenance free, except for 
peripherals with moving parts. But in truth, the 
keyboard unit and expansion box always need 
some maintenance, all of which is covered 
throughout this book. In summary: 

1. Clean edge card connectors and check 
cables regularly. 

2. Remove keytops (only on units with the 
older keyboards susceptible to keybounce) 
and blow out dust and clean contacts 
regularly. 

3. Blow out dust from the unit itself, and 
give it a shake, to remove any solder balls 
and splashes that may come loose as the unit 
gets older. 

4. Keep the unit covered when not in use. 

Care of Peripherals 

Cassette players. Using ordinary rubbing 
alcohol and cotton swabs, clean the head, capstan 
and pinch roller to remove all traces of brown 
tape oxide. Demagnetize the head using a 
commercial demagnetization cassette, or a head 
degausser (available at Radio Shack); follow the 
directions carefully so you don't make the 
problem worse. 

Always handle the player's buttons gently, as 
snapping them vigorously will not only shorten 
their life, but create enough vibration to throw 
the head out of alignment. If the head does get 
misaligned, or you suspect it is, turn to the details 
of cassette player maintenance in Chapter 6. 

In summary: clean all parts that come in 
contact with tape, and treat the unit's controls 
gently. 

Printers. Dot-matrix types like the Radio 
Shack line printers are workhorses, but there are 
a few cautions. First and foremost, never move or 
remove paper when the printer is in motion. The 
printed characters are formed by fine wires 
striking against the paper, and these wires can be 
bent if the paper is pulled against them. 

Keep ribbons in good condition, because a 
ribbon with a slight tear can also catch on a head 
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and damage the dot-matrix wires. Open the 
printer and blow out dust and dirt regularly; if 
you are skilled in handling small machinery, 
lubricate the printer according to the Radio 
Shack maintenance manual. If you are a klutz, 
don't try; alignment of printers has to be accurate 
to 1/1 00th of an inch. 

In summary: keep printers free of dust and 
ribbons fresh. 

Disk Drives. These horrors are terribly 
sensitive. Like tape machines, the heads need 
cleaning, but use only head cleaning diskettes 
especially made for the purpose. If you have 
regular data read/write problems, there are 
several solutions: purchase a better disk 
operating system (DOS), and/or purchase and 
install an external data separator. 

Keep out of the drive's insides as much as 
possible. Alignment is sometimes vital, but 
again, unless you are very good with precision 
machines, don't try it yourself. And even if you 
are a born watchmaker, be overly careful with 
double-sided or double-density drives. 

In summary: beyond a regular cleaning, leave 
them alone. Oh yes, keep the drive cables well 
away from the monitor or any AC power cables. 

Exatron Stringy-Floppy. Despite the 
manufacturer's warnings, this unit does not come 
well aligned from the factory, and many units 
were shipped without head alignment cement 
(normally Lok-Tite, a grey compound) to hold 
heads firmly in place. Remove the cover of the 
unit and check for this gop. If it is not there, turn 
to Chapter 9 and follow the alignment 
directions. 

If the gop is not there, you'll need an oscilloscope. 
Turn the scope on, and adjust the vertical calibra- 
tion for full scale (maximum). Hook the scope's 
ground (black) lead to a convenient ground point 
on the ESF or the TRS-80, and place the hot (red) 
probe on Z6 — pin 7. Start the ESF reading a 
prerecorded tape from the manufacturer. If the 
wave won't stay in synchronization on the screen, 
or if it is outside the vertical bounds of the screen, 
adjust the scope until it is visible and stable. With 
a small screwdriver, adjust the playback head's 
alignment until the amplitude (height) of the 
waveform is at its maximum. Try several pre- 
recorded tapes to make sure of this position, and 
put some lok-tite on it. If you have your own tapes 
recorded on the ESF, you may have to move back 
and forth to and from the correct position, reading 
in the original position, and re-recording in the 
corrected one. 



Clean the heads and capstan with a very 
sparing and gentle application of rubbing alcohol 
on the end of a lint-free swab. Don't use Q-tips or 
their equivalent, but rather wrap surgical gauze 
around a lollipop stick. Blow dust out of the unit 
regularly. Remember never to operate the ESF 
in any position but on its feet. 

In summary: blow out dust, clean heads, and 
check for the presence of 'Lok-Tite' on the head 
screws. 

RS-232 Board. In another piece of dream 
engineering, the connection of this board to the 
expansion box was done via a flukey, 
solder-coated connector board pressed against a 
plastic bridge with plain metal contacts. Clean 
those contacts regularly with a fine cloth, and 
brush the solder-coated board connectors 
vigorously with a buffing cloth or extra-fine 
emery paper. Spray both sparingly with tuner 
cleaner, and quickly reattach them, constantly 
rocking the board to assure a firm connection 
until you have tightened the screws down. 

In summary: clean both sets of contacts 
occasionally, especially if you notice more than 
the usual transmission/reception errors. 

Diagnostic Programs and Loops 

Loading large-scale programs for diagnosis is 
not only time-consuming, but as often as not 
impossible when your computer is not working 
well. If BASIC can be brought up at all, then 
simple machine language diagnostics can be 
POKEd into place from command level. This 
section will present several of those loops, their 
use in trapping some of the possible difficulties, 
and how they can be used to examine the 
operation of the system. All these routines can be 
POKEd anywhere in your machine's memory; 
these examples all start at 5000 (20480 decimal). 



1. Checking the Write Circuits. 

This routine merely writes to a location and 
jumpsback to itself: 



Coding: 






AF 


XOR 


A 


32 00 3C 


LD 


[3C00J.A 


3C 


INC 


A 


18 FA 


Jfl 


S-4 



Listing 10-2. Write circuit diagnostic/machine. 

From BASIC: 

X=2Q480:P0KEX,175:P0KEX+1 ,5O:P0KEX+2,0:POKEX+3 ,60: 
P0KEX+4,60:POKEX+5,24:POKEX+6,25O <ENTEB> 

SYSTEM <ENTEB> 

/20480 <ENTER> 



Listing 10-3. Write circuit diagnostic/BASIC. 
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This routine will write the value in A, which is 
incremented from 00 to FF (0 to 255) each time 
the loop is passed through. The write line will 
pulse each time the LDd (3C00),A instruction is 
commanded. The first position on the video 
screen will flicker, as this is the memory location 
being written to. Press the Reset button to return 
from this routine. 



2. Checking the Read Circuits. 

Since each instruction must be fetched, this is 
only a simple loop: 



4. Checking the Input Circuits. 

This routine is similar to the write routine, but 
does not include any accumulator changes. 



Coding: 






DB 00 


IN 


A, (DO) 


18 FC 


JR 


»-2 



Listing 10-8. Input circuit diagnostic/machine. 

From BASIC: 

X=20480:POKEX,219:POKEX+1 ,0:P0KEX+2,24: 
POKEX+3,252 <ENTER> 

SYSTEM <ENTER> 

/20480 <ENTEH> 

Listing 10-9. Input circuit diagnostic/BASIC. 



Press the Reset button to return from this 
routine. 



Coding : 
18 FE 



JR 



Listing 1 0-4. Read circuit diagnostic/machine. 

From BASIC: 

POKE20480,24:POKE20481 ,254 
SYSTEM 
/ 20480 



<ENTER> 
<ENTEB> 
<ENTER> 



Listing 10-5. Read circuit diagnostic/BASIC. 

The Read line will pulse four times for every 
loop through this routine: twice for each 
instruction fetch, and twice for each refresh 
action. Press the Reset button to return from 
this routine. 

Listing 10-6. Output circuit diagnostic/machine. 

3. Checking the Output Circuits. 

This diagnostic is very much like that for 
examining the Write line, except that it triggers 
the Out line. 



Coding: 






AF 


XOR 


A 


D3 FF 


OUT 


(FF),A 


3C 


INC 


A 


18 FB 


JR 


i-a 



From BASIC: 

X=20480:POKEX,176:POKEX+1 ,211 :PQKEX+2,2S5:P0KEX+3 ,60: 
P0KEX+4,24:P0KEX+5,251 <ENTER> 

SYSTEM <ENTER> 

/20480 <ENTER> 

Listing 10-7. Output circuit diagnostic/BASIC. 

Each time the loop is passed through, the OUT 
line will be pulsed once, and the data present on 
the data lines will be incremented. This routine 
is also very useful because the cassette relay, the 
cassette data output, and the video screen will all 
demonstrate activity as the routine is looped 
through. Press the Reset button to return from 
this routine. 



5. Checking the HALT Line. 

Since the HALT line is gated together with the 
Reset button, executing HALT should return to 
ready (or reboot in a disk system). 



Coding: 
76 



HALT 



Listing 10-10. HALT line diagnostic/machine. 



From BASIC: 
P0KE20480,118 
SYSTEM 
/20480 



<ENTER> 
<ENTER> 
<ENTER> 



Listing 10-1 1. HALT line diagnostic/BASIC. 

Since the machine should return to READY, 
the Reset button need not be used. 



6. Checking the Video. 

This routine presents a screen full of 
characters, all identical, and increments through 
all 256 of the possible characters. With no lower 
case modification the screen will display three 
sets of upper case characters, followed by two 
sets of graphics characters. With a lower case 
modification, two upper case sets and one lower 
case, or one of each case plus a set of control 
characters will be displayed. 



Coding: 






AF 




XOR 


A 


21 


00 3C 


LD 


HL,3CD0 


11 


01 3C 


LU 


DE,3C01 


01 


FF 03 


LD 


BC.03FF 


77 




LD 


(HL),A 


ED 


8U 


LDIR 




3C 




INC 


A 


F5 




PUSH 


AF 


01 


00 CO 


LD 


BC.COOD 


CD 


60 00 


CALL 


0060 


M 




POP 


AF 


IB 


E9 


JR 


$-21 D 


isting 10-12. 


Video routine diag 


•nostic/ma 
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From BASIC: 

X=20480:POKEX,175:POKEX+1,33:POKEX+2,0:POKEX+3,60: 
POKEX+4 ,17: POKEX+5 , 1 : POKEX+6 , 60 : P0KEX+7 , 1 : 
POKEX+6, 2S5:P0KEX+9, 3 :P0KEX+10, 119 :P0KEX+11 ,237: 
POKEX+12,176:POKEX+13,60 <ENTER> 

P0KEX+14,245:P0KEX+15,1:P0KEX+16,0:P0KEX+17,182 
P0KEX+1 8 , 205 : P0KEX+1 9 , 86 : P0KEX+20 , : POKEX+21 , 241 
P0KEX+22,24:P0KEX+23,233 <ENTER> 

SYSTEM <ENTER> 

/20480 <ENTER> 

Listing 10-13. Video routine diagnostic/BASIC. 

Also, the VID* line (noted on the schematic in 
the Technical Reference Handbook) should 
pulse in very noticeable groups as each screen is 
printed. Use the Reset button to exit this 
routine. 



From BASIC: 

X=20480:P0KEX,62:P0KEX+1 ,65:P0KEX+2,5Q:P0KEX+3,232: 

POKEX+4 , 56 : POKEX+5 , 1 : POKEX+6 ,0 : P0KEX+7 , 48 : 

POKEX+B,205:POKEX+9,96:POKEX+10,0:POKEX+11,24: 

POKEX+12,243 <B»TER> 

SYSTEM <ENTER> 

/20480 <ENTER> 



Listing 10-17. Printer diagnostic I/BASIC. 



Print-and-Wait Routine 



Coding: 






3E 41 


LD 


A, 41 


21 EB 37 


LD 


HL,37E8 


77 


LD 


[HL),A 


CB 76 


BIT 


6,(HU 


20 FE 


JR 


NZ,< 


18 F4 


JR 


1-100 



7. Checking the Cassette Output. 

This routine calls the byte-output routine, and 
should write an FF (equal to eight timing pulses 
and eight data pulses) to port FF (the cassette 
output). 



Coding: 






3E FF 


LD 


A, OFF 


CD 35 02 


CALL 


0264 


18 FS 


JR 


»-5 



Listing 10-14. Cassette output diagnostic/machine. 



From BASIC: 

X=204B0:P0KEX,62:P0KEX+1 ,S55:POKEX+2,205:POKEX+3 ,100: 
POKEX+4, Z:P0KEX+5,24:P0KEX+6 ,248 <ENTER> 

SYSTEM <ENTER> 

/2O480 <ENTER> 



Listing 10-15. Cassette output diagnostic/BASIC. 

You should be able to measure (or hear) a 
constant group of pulses output to the cassette 
player. Note that the cassette player must be in 
record position, and must be running (the small 
plug must be removed) because this routine does 
not turn the cassette machine on. Use the Reset 
button to exit this routine. 



8. Checking the Printer. 

By writing data to address 37E8, the printer 
should react by printing that character. The 
following two routines output the letter 'A' to the 
printer; the first loops through a delay, 
outputting about five characters per second. The 
second waits for a printer handshaking signal. 

Print-and-Delay Routine 



Codiny : 






3E 41 


LD 


A, 41 


32 E8 37 


LD 


(37EB),A 


01 00 30 


LD 


BC,30Q0 


CO 60 00 


CALL 


0060 


16 F3 


JR 


»-11D 



Listing 10-18. Printer diagnostic ll/machine. 

From BASIC: 

X=20480:P0KEX,62:P0KEX+1,65:P0KEX+2,33:P0KEX+3,232: 
P0KEX+4,55:P0KEX+5,119:P0KEX+6,203:P0KEX+7 t 11B: 
POKEX+8,32:P0KEX+9,254:P0KEX+10,24:P0KEX+11,244 

< ENTER > 
SYSTEM <ENTER> 

/20480 <ENTER> 



Listing 10-19. Printer diagnostic II/BASIC. 

9. Checking the Interrupt Line 

For this, of course, interrupt hardware must be 
attached to the system. In the case of the 
expansion box, the interrupt flip-flop must be 
cleared (see Supplement to Chapter 4). This 
routine performs that function. It is identical to 
the first service routine presented in the 
Supplement to Chapter 4, and so only the BASIC 
coding is presented. 

From BASIC, attempt to use this program 
instead of direct POKEs, because there are so 
many values: 

10 FOR X = 20480 TO 20926 : READ A : POKE X,A : NEXT 

20 STOP 

30 DATA 243,62,195,50,18,64,33,20,50,34,19,64 

40 DATA 33, 25, 26, 229, 237, 86,251 ,205 

50 DATA 243,245,229,213,187,58,236,55 

60 DATA 58,224,55,33,17,1,17,37,62,1,26,0 

70 DATA 237,176,193,208,225,251,201 



SYSTEM 
/ 20 480 



<ENTER> 
<ENTER> 



Listing 10-20. Interrupt line diagnostic/BASIC. 



This routine, as described, returns to BASIC 
command level and displays a RADIO SHACK 
LEVEL II BASIC message continuously on the 
screen. 



Listing 10-16. Printer diagnostic I/machine. 
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10. Checking Speed Modifications 

Among the possible high speed failures are 
miswirings, ROMs which are two slow, and 
RAMs which are too slow. Combinations of these 
can make diagnosing a locked-up computer very 
frustrating. 

The two routines below test, respectively, 
RAM calling ROM, and RAM alone. The RAM 
routine may be moved to higher memory for 
testing that area; a version at 5000 and B000 are 
provided. 

Coding: 
RAM-Resident Version - Origin is at 5000 



32 60 


3D 


LD 


(3D601.A 


3C 




INC 


A 


F5 




POSH 


AF 


AF 




XOR 


A 


D3 FE 




OUT 


(FE),A 


F1 




POP 


AF 


32 61 


3D 


LD 


(3D61) ,A 


F5 




PUSH 


AF 


3E FF 




LD 


A,FF 


D3 FE 




OUT 


[FE),A 


01 00 


10 


LD 


BC.1000 


OB 




DEC 


BC 


7B 




LD 


A.B 


B1 




OR 


C 


g0 FB 




DJNZ 


FB 


F1 




POP 


AF 


C3 00 


BO 


JP 


5000 


ROM-Resident 


Version 





Remove Lines merked (•) end replece with: 
CD 60 00 CALL 0060 

High RAM-Resident Version 



Origin is at B00O; replace line merked [%] with: 
C3 00 B0 JP B0O0 

Listing 10-21. High-speed modification diagnostic machine. 

RAM/ROM Version 

Remove lines marked (*) and replace with: 
High RAM-Resident Version 
Origin is at B000; replace line marked with 
percent sign with: 

Since speed changes can affect the operation of 
BASIC, a version with POKE may be useless; if 
not, however, here is the RAM-resident version: 

X=204B0:P0KEX,50:P0KEX+1 ,96:P0KEX+2,61 :P0KEX+3,60: 
P0K.EX+4 , 245 : POKEX+5 , 1 75 : P0KEX+€ , 21 1 : P0KEX+7 , 254 : 
P0KEX+B.241 :P0KEX+9,50:P0KEX+10,97:P0K.EX+11 ,61 : 
P0KEX+1 2 ,60 :P0KEX+13 ,245:P0KEX+14 ,62 :P0KEX+1 5 ,255: 
POKEX+16,211:P0KEX+17,254:POKEX+1B,1:P0ICEX+19,0: 
POKEX+20,16 <ENTER> 

POKEX+21 ,11:P0KEX+22,120:P0KEX+23,177:P0KEX+24,32: 
POKEX+25,251 :P0KEX+26 ,241 :P0KEX+27 ,195:P0K£X+28,0 : 
POKEX+29,80 <ENTER> 

Listing 10-22. High-speed modification diagnostic BASIC. 



Diagnostic Programs 



For the ROM-RAM version, replace the last 
group of POKEs with: 

POKEX+21 ,205:P0KEX+22,96:POKEX+23,0:P0KEX+24,241 : 
P0KEX+25,195:P0KEX+26,0:P0KEX+27,B0 <ENTER> 

For the high RAM version, let X = -20480, and 
replace the last value POKEd (in either 
configuration) with 176. 

These routines will present, just below the 
center of the screen, a pair of characters. The 
first of these is printed in the machine's normal 
configuration (if OUT 254,0 sets your machine to 
normal). The second character is printed with 
the effect of OUT 254,255, which should turn all 
modifications on. Any failure in these routines 
should point to the specific area of breakdown. 
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111 CURES FOR THE COMMON CRASH 

Because TRS-80 computers are sold at 
the 'appliance' level, salespeople and 
users often forget that they are indeed 
computers, prone to all the problems that 
larger computers face. As a user of a 
personal computer, you become your own 
service representative, your own diagnos- 
tician, and your own repair agency. This is 
even more true if you have a custom TRS- 
80. 

This chapter is dedicated to you, the 
user, as service rep, diagnostic engineer, 
and repair person. 

I. SOFTWARE 

Symptoms of software problems: all error 
messages, system lockup and crash, just 
about everything that doesn't snap, crackle 
or pop. 

1. Correct the program- the greatest 
cause of crashes. 

By far the largest cause of computer 
'crashes' is the software. Mishandling of 
POKE, PEEK and VARPTR are most 
common as well as improper input/output 
routines, and insufficient error- checking. 



If crashes seem to occur only in specific 
programs, check these for errors before 
turning to hardware cures, although a 
'stuck bit' may always turnup a consistent 
error. 

2. Set memory size correctly for 
machine language or hybrid programs. 

Memory size is a boundary above which 
BASIC is prohibited. BASIC is not 
merely the source program, but consists 
of variable and string storage and the 
BASIC stack. Some of this uses high 
memory, and when memory size is not set 
as specified, these variables and stack 
information can run into the high- memory 
machine language program. 

3. Wait out or re-write long string 
searches and sorts. 

The memory allocation method for strings 
has made 'garbage collection' techniques 
necessary. When sorting is complex and 
the number of strings is large, this process 
can take from a few minutes to an hour, 
during which the computer seems locked 
up. One cure is clearing as much string 
space as possible; when all variables have 
been defined, break and PRINT MEM. 
To the program, add a line such as CLE AR 
MEM-N, where N is about 100 bytes 
more than the difference between the 
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program with all variables defined and 
your total memory; subtract about 20 
bytes from the CLEAR statement for 
each nested FOR-NEXT loop and 
GO SUB. Refer to 'BASIC Faster and 
Better' and other books for techniques of 
rewriting string handling using variable 
pointers, and otherwise using memory 
economically. 

4. Read the manuals. 

Most bugs are called 'features' by 
program authors. Discover these features 
in the program documentation. 

I. POWER 

Problems Caused by Poor Power: system 
reboot, unexpected syntax errors, speckles 
on screen, shrinking screen, unexpected 
disk or Stringy-Floppy startup, total lockup 
of system. 

5. Add a line filter or power supply 
monitor. 

'Clean' power enhances system reliabil- 
ity. The simplest help is a line filter such 

as that sold by Radio Shack. More severe 
power problems can be ameliorated by 
using power supply monitors such as 
Topax or Mayday. Isolating other appli- 
ances (power tools, washers, refrigerators, 
toasters, water pumps, fluorescent lamps, 
etc.) from your computer's outlet will 
enhance reliable operation. You can even 
build some very simple filters yourself: 



20 turns heavy solid 
wi re [insulated] . 



0.01 wF 
400 V 



j^*^r^r\. 



l^LL 



0.01 uF 
400 V 



6. Use 3- wire grounded circuitry for 
all equipment. 

3 -wire circuitry is electrically quieter 
and safer. Some equipment, particularly 
printers, have damaged computers when 
used in an ungrounded or improperly- 
grounded environment. If you have an 
older, 2 -wire system, test for floating 
voltages using a neon test light, available 
from hardware stores. Reverse the plugs 

in the socket until all voltages disappear. 

7. Stop strong power drains (granite 
sheds, arc welders). 

Strong power drains are visible as brief 
but distinct shrinking and dimming of the 
video. Cassette and disk I/O problems 
are most likely, but power drains can 
sometimes result in program failure. A 
high quality power supply monitor can 
help. Also, if you don't live in an industrial 
area, your power company or zoning com- 
mission might be able to assist. 

8. Fuse in the power supply might be 
going or gone. 

All separate TRS-80 power supplies 
contain fuses in order to receive an Under- 
writers Laboratories approval. Earlier 
supplies are sealed, but the seal can be 
broken by forcing a screwdriver around 
the joint at the bottom of the supply and 
gradually popping off the top section. 
Later supplies have screws under the 
rubber feet. Fuses are cheap. Don't test 
the fuse, replace it. It will need to be 
resoldered since these fuses are not in 
sockets. 

9. Replace or resolder faulty power 
cables at the connector. 



117V 



120V 



Line isolation 
transformer 



T 

X 



0.01 uF 
400V 



The power connector is not molded in 
place, and after a year of abuse, the 
soldered connections can break inside. 
Lift the tabs on the plastic sheath and pull 
it back. The connector can be resoldered. 
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If the power remains intermittent, the 
problem may be at the point where a band 
of metal is crimped around the cable. 
Loosen it, cut the cable shorter, and 
resolder. The 5-pin DIN plug is sold by 
Radio Shack if you want to replace it 
completely. 

10. Install a lightning arrestor in 
spite of the phone company. 

If you have a direct- connect modem, 
lighting strikes may be damaging your 
system, or at least affecting its perfor- 
mance. For best protection, always unplug 
the system from the phone and power 
lines when a storm is in the area. You can 
also obtain a Til lightning arrestor from 
Datadyne, 450 Seventh Avenue, NY 10001. 



II. EDGE CONNECTORS 

Symptoms of edge connector problems: 
system reboot, unexpected syntax and line 
number errors, loss of the end of a program 
or text file, system lockup, return to READY 
before program end. 

11. Clean edge connectors by erasing 
them. 

Since the solder- coated edge connectors 
are prone to corrosion, they must be 
cleaned regularly. The simplest methods 
are vigorous rubbing with a piece of 
coarse paper like a dollar bill, or erasing 
with pink pearl (good) or white plastic 
(best) erasers. 

12. Spray edge connectors with 
contact cleaner and swab with cotton. 



Once you have cleaned the edge 
connectors thoroughly, a weekly applica- 
tion of a small amount of spray contact 
cleaner (such as Radio Shack 64-2320), 
followed by rubbing with a cotton swab, 
will keep the contacts in good shape. 



13. Emery-paper edge connectors for 
really bad corrosion. 

For really bad corrosion or scoring from 
continuous insertion and removal of con- 
nectors, the finest grade of emery paper 
or cloth can be used. Use wet-or-dry 
paper soaked in contact cleaner or diluted 
isopropyl alcohol, and rub smoothly along 
the connectors. Follow up with more 
contact cleaner and cotton swabbing. Rub 
just enough to bring up a shine, and do not 
use coarse emery paper. Never sand down 
to the copper traces. 

14. Silver solder the edge connectors 
with Silver-It. 

Corrosion can be reduced to a minimum 
while maintaining the original physical 
size and shape of the edge connectors by 
obtaining a Silver-It kit from Fuller 
Products, Grand Prairie, Texas. This is a 
process that must be completed with 
great care, but will result in connectors 
that (except in chemically violent atmos- 
pheres in major cities) need virtually no 
cleaning. For Radio Shack repairs, this 
process looks like no modifications have 
been made. 

15. Gold plate the edge connectors. 

Most difficult of the solutions is gold 
plating, which is also a poisonous process. 
However, when it is complete, the result 
will be connectors of the original physical 
size with a corrosion-free gold coating. 
Refer to 80 Microcomputing, December 
1981, for full details. 

16. Replace the connectors with gold 
plugs from EAP. 

Easier than silvering or gold plating and 
less annoying than regular cleaning are 
replacement gold edge connectors (Gold 
Plug 80) sold by EAP Products, Box 14, 
Keller, Texas. Because the connectors are 
made by Kel/Am, they do not mate properly 
with AP Products connectors. Peri- 
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pherals using AP connectors can be easily 
changed to use the T&B/Ansley connector 
sold by Radio Shack. Also, the Gold Plug 
80 connectors will protrude from the 
keyboard unit and expansion box some- 
what less than an inch. 

17. Solder all the connectors into one 
box and one board. 

Model III cases can be purchased as 
replacement parts through Radio Shack's 
National Parts distribution system. If you 
wish to have a one-piece system, this can 
also cure the edge connector problem. 
Heavy pieces of copper wire can be 
soldered to the keyboard and expansion 
edge connectors, effectively creating a 
single large board. Don't solder a cable in 
place and then put one board on top of the 
other, because electronic noise will be a 
problem. 




18. Both unbuffered and buffered 
cables are inserted only one way. 

The buffered cable is marked clearly as 
to which end connects to the keyboard 
and which end to the expansion interface. 
However, the unbuffered cable is also 
directional because it contains a shield 
which should be connected to ground. If 
the cable is reversed, the large shield will 
be connected to a system reset signal — a 
sure troublemaker. Examine the cable for 
a fine copper wire sliding out from be- 
tween the grey plastic 'sandwich'. It 
should be on the left side of the cable 
when the cable is attached, with the 
smooth face of the cable toward the top. 



19. Cables not inserted all the way or 
crooked on connector. 

Interconnect cables, particularly AP 
Products connectors, need to be fully 
inserted to make electrical contact. Al- 
though the expansion cable is not usually 
inserted partly or crooked, it is easier to 
do with the printer and disk cables, which 
are somewhat out of sight. Also, Kel/Am 
connectors have a limited life — about 50 
insertions and removals before the con- 
tacts bend inside the connector. Examine 
the end — all contacts should be even. 

20. File carefully to cure a tight fit on 
the edge connector. 

Most Model I TRS-80's contain 
printed circuit board slightly thicker than 
that normally used with edge connectors. 
Although the cable will go on, it has to be 
forced. To avoid this, smooth the very 
edge of the circuit board with a fine file, to 
round the edge. File back not more than 
1/8 inch: 




III. MEMORY 

Symptoms of memory problems: erratic 
operation, unexpected syntax, unidentified- 
line, next-without-for and subscript- out- of- 
range errors, incorrectly reported memory 
on power- up, program lock-up. 

21. Replace slow memory with faster 
chips, but check speeds. 

All dynamic memory has a window 
during which data is valid for the CPU. 
Refer to Chapter 4 for a table of memory 
speeds for keyboard unit and expansion 
interface. Also, note that memories can 
deteriorate with age, and poorer access 
time is one of the first signs of age. 
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22. Replace bad memory with good 
memory, using a memory test. 

A memory test will reveal memory chips 
which are genuinely bad, identifying both 
their address and the bit (chip) involved. 
Remember that addresses 4000-7FFF 
are in the keyboard, and the expansion 
interface contains two banks, 8000-BFFF 
and COOO-FFFF. 

23. Replace older memory with newer 
(post-1979) memory. 

Early dynamic memories were plagued 
with the occasional 'soft error' — a pro- 
gram crash not caused by any permanent 
hardware affliction. The error was finally 
identified as a slow emission of alpha 
particles from the substrate (base) of the 
memory circuitry inside the chip. These 
particles would strike a memory cell, 
changing it. The occurrence was unpredic- 
table. The best cure for this dilemma is 
the replacement of all such memories. 
Date codes are stamped on the chip in 
year/week format, such as 7851 (end of 
December 1978); use memories with an 
8001 or later date code. 

24. Increase access with a modifi- 
cation to Z69. 

If the problem seems to be slow or aging 
memory, the Z69 modification can help. 
Cut trace from Z69 pin 5. Attach Z69 pin 
12 either to Z69 pin 10 or to Z69 pin 13. 

25. Install a buffered cable according 
to modified Radio Shack instructions. 



When memory failure seems to occur as 
more items are added to the system via 
the expansion interface, then (in earlier 
units) a buffered cable is called for. It 
provides additional fan-out (drive) capa- 
bilities to the keyboard unit. This item is 
available from Radio Shack at no charge 



to owners of early expansion interfaces. 
You can identify the earlier interfaces 
because the 32 K memory runs from back 
to front; in newer boxes it runs along the 
back. Refer to Chapter 4 for installation 
instructions. 

26. Install the twisted-pair DIN plug 
modification. 

In addition to the buffered cable, some 
earlier interfaces may require the 'twisted 
pair' modification. This is a 6-wire DIN 
cable combination to carry memory select 
signals RAS, CAS and MUX. Refer to 
Chapter 4 for installation instructions. 

27. Modify twisted pair resistors 
upward to 470/680 ohm pairs. 

If the installation of the twisted pair mod 
deteriorates rather than ameliorates oper- 
ation, change the resistor values specified 
by Radio Shack to 470 ohms to ground, 
and 680 ohms to 5 volts. Both are 
originally 220 ohms. 



28. Straighten bent pins under 
socketed ICs. 

Memory chips and the CPU were the 
only chips socketed in earlier machines. 
However, various runs of the computer 
had the character generator, line buffers, 
and so forth, in sockets. Evidence of bent 
pins is a machine which acts up when 
given a light physical shock — such as 
hard typing. Lift each IC and check for 
bent pins; be sure not to bend any pins 
when putting it back! If your machine has 
had a recent trip to salt-water environ- 
ments, the problem will be more severe; 
see #104. 

IV. FIRMWARE 

Symptoms of firmware problems: incor- 
rectly read data, equality failures in IF- 
THEN statements. 
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29. POKE 16553, 255 to correct 
READ/DATA error. 

In Version 1 of the Level II ROM, under 
certain conditions the same data would be 
read over and over, with the data pointer 
not being stepped through memory. The 
most common fix is POKE 16553,255 
added as the first line of any program. 
Also, any INPUT statement before the 
reading of data begins will take care of 
properly stepping the pointer. 

30. There are floating point accuracy 
errors, such as X-YO X-Y%. 

Because of the way real numbers are 
handled digitally, there is a very small 
numeric residue left after some types of 
calculations. Where IF-THEN state- 
ments don't seem to work when you know 
they should, break into the program and 
print the offending variables. Chances are 
you will see that a value, instead of being 
20 as you expected, is actually 20.00001 
as a result of residual binary information. 
Use integers where you can for such tests; 
see the Level II manual for details. 

V. RS-232 

Symptoms of RS-232 problems: incor- 
rectly received or transmitted characters, 
system crashing or lockup when not using 
RS-232, electronic failure. 

31. Place bar across RS-232 to keep it 
in place. 

Heat buildup and general stress in the 
expansion box will cause a warping of the 
RS-232 board, lifting some contacts 
above the connection pins, or making the 
unit vibration sensitive. By using longer 
mounting screws and a heavy insulated 
metal bar, the warp can be prevented. 
You may have one made at a local metal 
shop, then cover it with 'heat-shrink' 
tubing sold by Radio Shack. Recently, 
some sources have been making such bars 
available; look for ads. 



32. Clean RS-232 contacts vigorously 
with cotton cloth. 

These contacts too are solder-plated, 
and prone to corrosion. But they are also 
very thin, and only a clean cotton cloth - 
together with vigorous rubbing (and per- 
haps a little contact cleaner) should be 
used. Make the contacts shiny. 

33. Reseat the RS232 board, checking 
for bent pins. 

The RS-232 board contacts are 1/20 
inch from center to center, exactly half the 
size of the edge connectors. Bent pins on 
the expansion interface RS-232 connector 
can cause shorts which will affect not only 
the operation of the RS-232 system, but 
the computer as a whole. Reseat the 
board, checking under strong light that all 
the connecting pins are straight and con- 
tact properly. 

34. COM/TERM on RS-232 must be 
in correct position. 

Recheck the RS-232 manual, and make 
sure that the Communications/Terminal 
switch is in the correct position for the 
software you are using. 

VI. DISK 

Symptoms of disk problems: lost data, 
hang-up during disk access, rattling and 
banging of disk mechanism. 

35. Use better disks, the best you can 
get if data is critical. 

If you've spent an hour entering data, 
you've paid for the best diskette you can 
buy. Purchasing cheap disks is false 
economy. 

36. Install a data separator, doubler, 
or other separation. 

Data is stored on disk as a continuous 
stream of clock pulses separating data 
pulses. As a matter of economy, Radio 
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Shack chose to use 'internal' separation 
— that is, using the disc controller inte- 
grated circuit to distinguish between clock 
and data pulses. The disc controller's 
manufacturer does not recommend this 
method; therefore, a piggyback data 
separator (sold by several sources) rein- 
states the proper electronic design. 
Similarly, a double-density controller con- 
tains the essential data separation. If you 
obtain a 1771B-01 data sheet from 
Western Digital Corporation, you can 
build your own data separator. 

37. Align the disk drive read/ write 
head professionally. 

When a single-drive system is in use, 
misalignment of a drive head might not be 
noticed. However, in a multi- drive system, 
one drive may produce an unusual number 
of re-seeks or error messages. If you 
suspect misalignment of the head, don't 
attempt to service it yourself. You can 
obtain an alignment diskette (a good one 
is manufactured by Dysan) to confirm 
your suspicions, but professional service 
is called for in this case. 

38. Clean the disk drive read/write 
head with cleaning disks. 

When a large number of disks are in use, 
especially inexpensive ones, tiny bits of 
oxide are shed onto the drive read/write 
head. Since this is not immediately 
visible, it's good practice to obtain a disk 
cleaning kit (Scotch and others) and use it 
weekly. 

39. Erase-clean connections to the 
disk drive. 

The edge connector to the disk drive is 
afflicted with the same corrosion problem 
as other edge connectors. The solutions 
are the same: cleaning, plating, and 
replacement with gold plugs. See under 
edge connectors (#11 above) for more 
information. 



40. Replace 74LS38/LS16 c 
lector ICs and socket them. 

The cable to disk drives is long and must 
be driven by higher- current integrated 
circuits, type 74LS38 (74LS16 in the 
newer expansion box). These can often 
break down under continuous use and in 
situations where the drives are often plug- 
ged in incorrectly. The most evident 
symptom is failure during formatting or 
backup, because the stepping signal (low 
to move outward, high to move inward) 
deteriorates and missteps the read/write 
head. Remove these chips, and solder in 
sockets. Then keep a small stock handy 
so they can be replaced when these symp- 
toms show up. 

41. Lubricate disk drive and rails 
sparingly with silicones. 

Many disk drives squeal and clatter. 
There is no need to risk mechanical 
failure. Remove the cover and lubricate 
the motor bearings and the guide rails; 
use only a very light grade silicone lubri- 
cant, and wipe any extra lubricant off once 
it has spread across the area that needs it. 
Refer to Exclusive Oracle, 80 Micro- 
computing, January 1982, for details. 

42. Keep the disk door closed till it 
stops to protect loaded heads. 

Your disk drive may contain 'loaded' 
heads, which means that the door 
mechanics do not lift the head away from 
the disk when the door is opened. If you 
remove or insert a disk before the select 
light goes out, you may damage the head 
assembly. You can tell if your drive has 
loaded heads from the documentation, or 
by listening for a 'clack' when the drive is - 
selected, and a second 'clack' when the 
select light goes out. In any case, it is good 
practice to leave the disk in place in any 
drive while the motor is spinning. 
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43. Put disks in correct keyed cable 
position. 

Disk drive selection (drive to 3) can be 
made in two ways: the drive itself may be 
programmed with internal jumpers, or the 
cable may have teeth pulled to eliminate 
the unwanted select signals. If your drive 
programming and missing teeth do not 
match, then the drive will appear dead 
when selection is attempted. Make sure 
your drives are marked 0, 1, 2 and 3, and 
that you match them correctly to the 
cable. 

44. Disk cable must be right side up. 

If your disk drive keeps running and 
doesn't otherwise work, the drive is prob- 
ably plugged into the cable upside down. 
Try reversing the connection. Since many 
drives have cables protruding out the 
back, and the physical position of these 
cables is not standard, the plug-in may 
look correct with respect to the other 
drives, but be backwards. 

45. Disk cable must be fully installed 
inside case. 

The cable protruding from the back of 
some brands of disk drives is usually not 
hard-wired, but simply an extension cable 
from an internal edge card. Under the 
weight of the long multi-drive cable, or 
simply from regular moving and unplug- 
ging, this internal connector can come 
loose, resulting in erratic operation. 
Remove the case top and re-insert the 
extension cable. A piece of strong plastic 
packing tape can keep this cable from 
shifting. 

46. Insert the disk correctly into the 
drive. 

This is not as obvious as it seems. If you 
mix different brand drives on your system, 
you may discover some in which the disk 
must be inserted with the write-protect 
notch pointing down rather than up. 



Usually the write-protect notch points 
toward the side of the drive where the 
select light is mounted, but even that is 
not standard. Be especially careful about 
this when using an unfamiliar system, as a 
hangup during disk access can be fatal to 
data in memory. 



47. Remove or pad sources of vibra- 
tion nearby disks. 

If you have lived or worked in an area for 
some time, you have probably blocked out 
sources of vibration, such as heavy equip- 
ment, trains, etc. However, this kind of 
vibration can ruin a disk write or read. 
The simplest solution is padding: a layer 
of heavy cloth, a layer of cork, a layer of 
wood or metal. If you have occasional 
inexplicable read/write errors, tune your 
senses to the environment. 



48. Update the DOS, especially if it's 
an early version of TRSDOS. 

Most of the bugs and inconveniences of 
early versions of TRSDOS have been 
corrected either by Radio Shack, or by 
other software houses who have created 
new disk operating systems. To avoid 
frustrating errors, update your DOS. 

49. Keep disks clean, unbent, and 
store them straight up in cases. 

Though this may seem obvious, there are 
hidden causes of dirt: smoking, heavy 
dust or other airborne particles, air 
freshener sprays, animals, etc. Bending 
can be caused by storing disks sideways, 
keeping them in a car window, or inserting 
them hastily into the drive. Don't drink 
soda nearby — unless you put your disks 
right back in their sleeves (which you 
should do); the bursting bubbles of car- 
bonation can carry sugar residue to the 
disk surface, damaging the recorded data 
and abrading the disk head. 
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VII. TAPE 

Symptoms of tape problems: loading impos- 
sible, hangup during load tape won't go on 
or off, tape won't record. 

50. Align the tape recorder head by 
drilling a hole. 

Misalignment is singly the largest tape 
problem. Put the recorder in playback 
mode with no cassette in place, and shine 
a bright light so you can see the Phillips 
alignment screw to the left of the tape 
head. Drill a hole directly above it. Align 
the head by popping in a good commercial 
music tape, and turning the screw until 
the sound is at is brightest. Use this for 
standard recording and playback, but 
readjust for any commercial tapes that 
don't sound 'bright'. 

51. Clean the tape recorder head with 
isopropyl alcohol only. 

An oxide buildup is common on all tape 
recorders. Using head cleaner or iso- 
propyl alcohol (not acetone!), swab the 
tape head and other metal parts which 
exhibit brown oxide caking. This will 
prevent scratching or scraping of the tape 
surface, as well as ensure good contact 
with the tape head. 

52. Demagnetize the tape recorder 
head with proper devices. 

The high frequencies are the most 
crucial element in good tape loading, and 
a magnetized tape head erases some of - 
these high frequencies every time the 
tape is played. Pick up a cassette tape 
head demagnetizer, either a plug-in type 
or the kind packaged in a cassette case, 
and demagnetize the cassette player at 
least monthly. 

53. Use better tape but not the very 
best audio stuff. 

Good tape will always give good loads. 
Avoid inexpensive tapes like Certron, 
Concertape, and questionable depart- 



ment store house brands. Radio Shack 
red-label Realistic tape is just fine, as is 
most any good audio tape. Very high 
quality tapes (chromium dioxide, metal, 
etc.) are not necessary, except for archival 
backups. Digital tapes from Microsette 
are only about $.65 and are sold in handy 
lengths (C-10 and C-20). 

54. Modify the CTR-80 with a diode to 
prevent head glitches. 

If the stop button was pressed during 
loading, a head field collapse in early 
CTR-80 tape recorders would put glitches 
on program tapes. Radio Shack provides 
a free modification for this problem. If 
you wish to do it yourself, a small silicon 
diode (such as type 1N4148) can be 
connected across the tape head contacts. 

55. Replace cassette relay to prevent 
sticking. 

The current drain of the CTR-41 tape 
recorder, and many non-Radio Shack 
recorders, is too high for the relay contacts 
in the keyboard unit. This causes it to 
stick closed, keeping the tape recorder 
running when it should not. There are two 
options: change tape recorders, or change 
relays. The relay change is permanent, 
and a new unit can be obtained from Lab 
Service, Inc., in Hustisford, WI. 

56. Use CTR-80 to prevent cassette 
relay burnout. 

If you don't want the trouble of replacing 
a relay, use a CTR-80 tape recorder. It 
also prevents wear and tear on the cables, 
because rewind and fast-forward can be 
used without pulling the motor-control 
plug. 

57. Clean the capstan and pinch 
roller with isopropyl alcohol. 

As the tape recorder sees a lot of use, two 
things will happen to the rubber pinch 
roller: oxide buildup and glazing. Oxide 
buildup is similar to that on the tape head, 
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but on the roller it can cause tape to slip 
out of place, creasing it. Glazing is a 
shininess of the rubber surface, also caus- 
g tape slip and speed variations. Both can 
be cured with the liberal application of 
isopropyl alcohol, acetone, or tape roller 
cleaner. Hard-glazed rollers need to be 
brought down with fine emery paper. 
58. Add a switch box to the cable 
assembly for hand operation and 
sound. 

A very useful addition to your tape 
system is a small switch box containing a 
speaker; headphone speakers are best. 
With a simple two- switch box you can 
listen to programs being saved, keep the 
motor running, and stop it when you wish: 



r^lr 




i 

59. Get the XRX-II cassette modifi- 
cation. 

Radio Shack created a special cassette 
system modification, which is available at 
no charge. It improves 500-baud loading, 
but consists of a 500-baud window — 
which means using cassettes running at 
any other baud rate (hardware or software 
based) is impossible. However, the modi- 
fication can be switched out if you wish to 
have the advantages of good 500-baud 
loading and not lose the option of other 
speeds: 

60. Ground loop hum in cassette 
system is cured by breaking the loop. 

Some loading problems can be attributed 
to hum during program saves. This is due 
to a 'ground loop' created by the input and 



output cables. Pull back the plastic 
sheath on the computer end of the cassette 
cable, and cut either one — but not both 
— of the two shields going to ground (pin 
2, the center pin). This will kill ground 
loop hum. 

61. Replace or resolder a faulty cas- 
sette cable at the connector. 

If you often pull the cassette cables out 
of the recorder, you may break the internal 
wiring. This will be evident as a crackling 
sound during program saves, or partial 
good loads from tapes which once loaded 
perfectly. You can replace the connectors 
with mini and submini plugs, or you can 
obtain a complete new cable. 

62. Replace the dual cassette relay or 
driver IC. 

If the dual- cassette system from the 
expansion interface ceases to function, 
either the relay or its associated driver 
integrated circuit (Z41) may be bad. You 
can test the operation with: 



1 A=1 4308: POKEA , : F0RX=1 T09: NEXT 
:P0KEA F 1 :F0RX=1Tu9:NEXT:GuT01 

The relay in the expansion box should 
clack rapidly. 

63. Cassette cables must go to correct 
expansion box positions. 

If one cassette seems to load and the 
other doesn't, then check that the cas- 
sette cables are properly installed. The 
order (looking from the back) is not parti- 
cularly logical: Common Cable, Cassette 
#1, Cassette #0. 



VIII. HARDWARE 

Symptoms of hardware problems: loss of 
power, changing of memory contents, key- 
board lockup, no apparent expansion inter- 
face memory, miscellaneous woes. 
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64. Tighten the power transistor 
screw and resolder screw head. 

The keyboard unit's power transistor 
(Q2) was screwed into place, with the 
screw acting as an electrical connection. 
This screw can corrode, resulting in erratic 
operation and frequent complete system 
crashes. Remove, clean and tighten this 
screw. 

65. Terminate data lines either up or 
down, but only once. 

The eight data lines are flying free in the 
TRS-80 system. For reliable operation, 
they should be terminated with resistors 
— but only once. Since some peripherals 
contain terminating resistors, the best 
idea is to obtain an edge connector, and 
solder resistors to it. Eight resistors (680 
ohms, 1/4 watt) go from data lines to 
ground, eight resistors (470 ohms, 1/4 
watt) go from data lines to 5 volts. 

66. Add two capacitors to RAM bank 
the expansion interface. 

The absence of two capacitors from the 
expansion interface has never been ex- 
plained. There was a place for them, and 
their inclusion improves operation. Install 
two electrolytic capacitors (10 mF, 16V) 
in the positions marked C54 and C55 in 
the two rows of memory in the expansion 
interface. 

67. Replace the CPU with a Z80A for 
high speed, or a Z80B for best 
operation. 

If you are running your computer at high 
speed (100% increase or greater), you are 
exceeding the formal specifications for 
the Z80 processor. Although many Z80s 
can run at that higher speed, certain 
complex operations (stack operations, for 
example) can fail. Replacing the chip with 
a Z80A (4MHz version) or Z80B (6MHz 
version) will enhance reliability. 



68. Replace memory for high speed, 
but observe DDU wiring changes. 

Replacing expansion interface memory 
for high speed operation may not always 
help run the machine reliably.' Newer 
expansion boxes contain a digital delay 
unit for memory selection, which has a 
fixed access time. Refer to Chapter 4 for 
wiring changes to the DDU for high speed. 

69. Check power supply voltages 
with a calibrated meter. 

Since the miniature voltage adjustment 
controls were not lacquered, vibration can 
cause them to move, resulting in the 
voltages being out of calibration. Units 
showing as little as 3.2 volts on the 5 -volt 
line have been seen. Obtain a calibrated 
meter (not a $10 off-the-shelf number) 
and adjust the voltages — 12 volts first, 
then 5 volts. These are R10 (12 volts) and 
R5 (5 volts) in the keyboard unit. 

70. Increase C48 in the expansion 
interface to keep the disk going. 

A discouraging aspect of some disk 
operating systems is that they cannot 
recover from a disk drive which has 'timed 
out' — the motor has stopped. Some 
DOSes contain a Shift/Break option, but 
this does not always function, depending 
on when the disk timed out. A better 
solution is to increase the value of C48 
(C62 in the newer expansion box) from 33 
mF to 47 mF or 68 mF. Use a bead 
tantalum capacitor, not an aluminum 
electrolytic, if possible. 

71. Add or remove disk termination 
resistors. 

In order for disk selection to take place 
properly, termination resistors are re- 
quired. Normally, these should only be 
installed in the furthest drive on the cable. 
However, as people trade or sell units, or 
purchase them from a variety of manufac- 
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turers, the number of termination resistors 
may vary. These can be found by remov- 
ing the disk drive cover; they are a red, 
white or blue integrated- circuit sized 
package, usually near the edge connector. 
Make sure only one set of resistors is in 
place, no matter how many drives are in 
the system. 

72. Make the reset modification to 
the expansion interface. 

It seems the option to turn off a disk 
system should have been provided with 
the expansion interface. Ironically, other 
manufacturers have followed the original 
unresettable design. You can get out of 
many program hangups by pressing reset 
in a Level II keyboard only — so why not 
with an expansion box attached? Refer to 
Chapter 4 for details. 

73. Change LNW termination resis- 
tors to 470/680 pairs. 

LNW expansion systems have placed 
very low termination resistor values in 
their boards. If too many peripherals (or 
any peripherals with their own termin- 
ation) are added to the system, computer 
lockup will probably occur. For reliability, 
these values should be changed to 680 
ohms to ground, and 470 ohms to 5 volts. 

74. Check the DDU in the newer 
expansion interface. 

Sudden failure of memory in new 
expansion interfaces can almost always 
be traced to failure in the digital delay unit 
(DDU), marked Z37. This unit should be 
slightly warm — neither hot nor cold — to 
the touch. Since replacement DDUs are 
about $20, get some help if you're not sure 
whether the DDU is bad. 

75. Make sure the ROM cable is okay, 
neither pulled from its sockets, nor 
with bent pins. 

If the computer crashes with an occasional 
screenful of garbage, or patterns of@ 9 @ 9 , 



@ A@ A, etc., or it fills the screen from the 
bottom left with AAA, then suspect a 
flukey Level II ROM cable, or a cracked 
DIP shunt (see #7 below). Make sure the 
cable is fully installed. No pins should be 
bent or broken on the cable; replace it 
with another 24-pin jumper cable if any 
pins are bent or broken. (If they're bent, 

chances are they'll be broken when you 
try to bend them back). 

76. Cold solder joints, splashes, balls, 
etc., can be anywhere. 

This is the worst problem. TRS-80 
computer boards are soldered mechani- 
cally, and residual solder bits are cleaned 
away. However, a few balls, splashes or 
hairs of solder may remain, breaking loose 
after the vibration of a year of use to cause 
trouble. Remove all cables and shake out 
the computer; small solder bits may drop 
out of the case. Also, broken traces can 
occur, particularly where any scratches in 
the green solder mask have occurred. 
This might be a 'professional help' category. 

77. Check DIP shunts for correct or 
accidental breaks. 

Another cause of @9@9, @A@A, 
@ S@ S, or the moving A A A A are DIP 
shunts. Only certain pins (see Chapter 4) 
should be broken in the DIP shunts (Z3 
and Z72 in the keyboard unit). DIP shunts 
may have hairline cracks; remove them 
and check with an ohmmeter to be sure. 
You can replace DIP shunts with DIP 
switches or ordinary staples. 

78. Reset problems are a bad CPU 
and related capacitor, no disk system 
in use, or are program-caused. 

Users who recently install an expansion 
interface often forget that the reset button 
no longer works as it used to, and this is 
particularly a problem if no disk drives are 
attached (see #72 above). However, 
there are three other reasons for reset 
failure, even if disks are in place: the reset 
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pin of the Z80 CPU is bad (meaning 
replace it), or the associated charging 
capacitor and bleeder resistor (R47 and 
C42) are bad (replace them), or the pro- 
gram attempts to use the machine lan- 
guage HALT intruction (see Chapter 3). 

IX. KEYBOARD 

Symptoms of keyboard problems: key- 
bounce, keys not working, multiple dif- 
ferent characters, continuous scrolling ?SN 
or ?S errors on screen, constant repeating 
memory size question followed by odd 
characters. 

79. Clean keyboard contacts — old 
one only — not ALPS. 

The most straightforward cure for 
keybounce is cleaning the keyboard. On 
the bounce-prone keyboards (see photos 
in Chapter 4), the keycaps lift off. The 
keys can be cleaned with dry air, spray 
cleaner (works well but requires cleaning 
more often), or filled with silicone grease 
(some people say this improves the feel of 
the keyboard). The latter technique re- 
duces bounce from vibration as well. 

80. Use KBFIX and other software 
instead of a new keyboard. 

A debounce program — automatic on 
most disk systems — can be loaded at the 
beginning of each session. Radio Shack's 
KBFIX is clumsy to get loaded, but 
works. The debounce routine presented 
in Chapter 3 works well. Note that new 
ROMs ('R/S L2 BASIC) contain a de- 
bounce routine, and a second routine 
added to this can result in very slow key 
response. 

81. Get ALPS keyboard, which is the 
debounced keyboard. 

If you can afford the $75 replacement 
cost, a Radio Shack Hall-effect ('ALPS') 
keyboard will permanently take care of 
bounce problems. If you switch often 
between BASIC and machine language 



programs, play games, or have a variety of 
disk operating systems or text editing 
programs, the ALPS keyboard may be the 
best solution. 

82. Replace 74LS05s in the keyboard 
if multiple or unusual characters 
appear. 

If multiple or unusual combinations of 
characters appear unexpectedly on the 
screen, or if characters begin to repeat by 
themselves, then the 74LS05s on the 
keyboard baseplate are probably bad. 
Replace them both, in sockets. 

83. Replace or repair the keyboard 
cable if odd stuff shows up. 

Another cause of odd character com- 
binations — usually this like 'FIAQ9' or 
some such when a single or pair of letters 
is pressed — is a cracked or intermittent 
keyboard cable. Replace it; see Chapter 
10. 

X. VIDEO 

Symptoms of video problems: no video, 
dim video, screen tearing or twitching, 
blurred screen, screen glitches. 

84. Add a buffer stage or resistor to 
cure video tear. 

Lowering the value of R14 in the video 
monitor will reduce the 'tearing' present 
when large blocks of graphics are dis- 
played, especially using reverse video. 
See Chapter 4 for details. The other 
option is to obtain a video buffer circuit 
from Archbold Electronics. 

85. Add a deglitch modification for a 
prettier screen. 

The video 'hash' created when graphics 
are being drawn is caused by a conflict 
between the relatively independent video 
display circuitry and the need of the CPU 
to access video memory. Add the deglitch 
modification for a clearer screen, pre- 
sented in 80 Microcomputing, Feb. 1982. 
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86. Get a new character generator, 
with descenders. 

Upper case characters on the TRS-80 
have always been consistent, but lower 
case characters can be displayed either 
with flying letters (g, p, q and y) or with 
descenders. The presence of a 'flying a' is 
normal on early computers. The new 
character generator with descenders can 
be obtained as a 'word processing char- 
acter generator' from Radio Shack. 

87. Horizontal and vertical image 
adjustment can be done. 

If the image is not centered on the screen 
(use 

10 F0RX=15360T016383:P0KEX,191:NEXT 
20 G0T020 

as a test program), adjust variable resistors 
R20 and R21 in the keyboard unit. 

88. Adjust horizontal and vertical 
sync on the monitor. 

If the image flickers badly, tears 
sideways, or rolls, the video monitor may 
be out of adjustment. Turn the white 
horizontal and vertical adjustment con- 
trols on the back of the monitor, just as 
with an ordinary television that exhibits 
the same symptoms. 

89. Add a capacitor to cure video 
twitch. 

A continuous, annoying screen twitch is 
the result of oscillations present at the 
video output. The insertion of a small 
capacitor (47 to 220 pF) between Z50 pin 
3 and ground will eliminate the twitch. 

90. Dimmers off. Get rid of the little 
runners on screen. 

Similar to a twitch is the 'runner', a 
shaking horizontal line that works its way 
up or down through the screen, rocking 
one line of letters back and forth. This is a 



kind of reverse RFI — not caused by the 
computer for a change — which can be 
cured by turning off light dimmers, faulty 
fluorescent or neon lights, or similar inter- 
ference producers. If you live in an apart- 
ment building, neighboring dimmers 
should not (but may) affect your computer. 

91. Adjust the monitor for blurred 
characters. 

There is no high-voltage adjustment for 
blurred characters; however, there are a 
few kludges. First, a higher line voltage (a 
full 120 volts) will increase the sharpness. 
Adjusting the internal vertical height con- 
trol may reduce the image to the more in- 
focus (center) area of the screen. 
Also, replacing the power transistor on 
the bottom of the chassis and the high- 
voltage rectifier (they both may exhibit 
undesirable characteristics) can improve 
the image. Unfortunately, the monitor is a 
very basic video display, and has few 
adjustments. 

92. Correct the lowercase software 
for LDOS. 

The 'universal' (alas, a dangerous word) 
lowercase modification presented in this 
book is not universal at bootup for one 
disk operating system — LDOS. How- 
ever, the LDOS driver can be invoked 
separately and will work; refer to the 
documentation. 

93. Check the 5 volts or the opto- 
isolator in the monitor. 

A hardly existent or dim picture can be 
caused by insufficient 5 volts into the 
video cable from the computer (check for 
a bad connection), or a weak or dying 
optical isolator on the plug- in card inside 
the video monitor. First, try another 
monitor. If the system works with that 
monitor, resolder the cable connection if 
necessary; if that does not work, replace 
the optical isolator. 
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XI. RFI 

Symptoms of RFI (Radio Frequency Inter- 
ference): herringbone across television 
screens, complete loss of TV stations, whist- 
ling on radio (AMorFM), disconnection of 
wireless telephones, blockout of shortwave 
transmissions. 

94. Shield the entire system for RFI. 

The TRS-80 system is a broad-band 
interference generator; that is, what it 
sends out affects all bands of radio and 
television reception. The interference 
can be lowered by shielding: spray the 
inside of the case with aluminum paint 
and hook that to signal ground; use 
shielded multi-conductor cable for all 
peripherals (it's expensive); and create a 
'Faraday cage' — if your decor will allow it 
— by shielding the room in which the 
computer is used with fine mesh. 

XII. HEAT 

Symptoms of heat problems: loss or lockup 
of program consistently after the machine 
has been on several hours. 

95. Ventilate case or add fan, latter if 
it's an all-in-one system. 

Normal ventilation using the slots cut 
into the TRS-80 and expansion box is 
adequate. However, if speed modifi- 
cations, internal memory additions, etc., 
have been made, the power supply is 
asked to do extra work. A hard desk with 
good circulation around the computer is 
essential, and a small' Sprite' type fan can 
be used occasionally to cool the system. A 
quiet fan may be added for continuous 
use, and is a necessity for an all-in-one- 
case system. 

96. Remove power supplies from the 
expansion interface. 

The two power supplies in the expansion 
interface generate a great deal of heat. 
With the video monitor stacked above, 



this can create an undesirably hot environ- 
ment for memory. Remove the two sup- 
plies from the expansion box; the system 
won't look as compact, but it will have a 
longer life. 



XIII. PRINTER 

Symptoms of printer problems: will not 
backspace or underline, will not move up a 
line at a time during program listings. 

97. Printer may need a line feed with 
every carriage return. 

Many printers require not only a carriage 
return, but a line feed as well; examples 
are Teletypes and some Centronics 
printers. If you have this problem, first 
check with the manufacturer for a modifi- 
cation kit or instructions. If none is 
available, use a disk operating system 
with a CR/LF option, a printer driver 
patch, or a text-editing system with the 
CR/LF option. A hardware addition can 
be made to most printer interfaces to 
generate a linefeed when a carriage return 
is received. 

XIV. USER PROCEDURE 

98. Hide furry animals, keep away 
from wood stoves, etc. 

Insignificant as it may seem, smoke is a 
severe abrasive to disks. Smoking, wood 
stoves, unskilled kitchen use (ahem), 
animal hair, and so forth, can result in 
airborne particles that affect disks, whose 
rotation acts as a static vortex to pull in 
those particles. Similar cautions apply to 
the piles of hair and grit that can gather in 
the keyboard. If you wonder just how 
much dirt is in the air, open the video 
monitor (with the power off, of course), 
and have a look. All around the high 
voltage will be piles of grit pulled in 
because of the electrical attraction. 
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99. Don't pull the cables while you're 
using the system. 

This might seem obvious, but realize 
that pressing the reset button jostles the 
cable, just as does moving the keyboard to 
make it comfortable. Dropping a pencil, a 
cassette, or a diskette case on the cable 
may generate noise; see Chapter 7 for 
vibration protection. 

100. Wait before power-up after 
power- down to protect memory. 

When the manual cautions to wait ten 
seconds before repowering the system, it 
is not merely because the system doesn't 
always fully reset during that time, but 
also because the application of power to 
the memory must be done in this order: -5 
volts, 5 volts, 12 volts. The -5 volt line can 
be lost with too hasty repowering of the 
system, and memory will be physically 
damaged. 

101. Neither steel wool, nor metal 
filings, nor metal bits should be nearby. 

Using the computer in a home 'shop' is 
dangerous. Wood bits may cause key- 
bounce and disk damage, but metal filings 
may cause the entire system to fail. A 
buildup of metal dust will decrease local 
resistance levels to short-circuits, or create 
unexpected current drains and intermit- 
tent operation. 

102. No water or drinks nearby or 
open windows. 

Drinking cups can damage disks, water 
glasses can fall over, carbonated soda can 
bubble tiny sugar globs onto tapes and 
disks, and open windows can invite water- 
carrying breezes and even rainstorms. 

103. No magnets nearby, especially 
unobtrustive refrigerator types. 

Refrigerator or bulletin board magnets 
are handy things, but because they are so 



ubiquitous, their danger to magnetic media 
is easy to forget. If there are any in the 
house, keep track of them . . . magnets 
shaped like daisies or fruits, bars, mag- 
netic kiddie letters, even magnetic screw- 
drivers and scissors. 

104. Watch out for salt air areas. 

There's nothing like salt air for corroding 
metal, and metal is the heart of the 
computer's interconnections. Integrated 
circuit pins can corrode, cables can corrode, 
even screw connections can corrode. In 
boards previously reliable, salt air can 
corrode unseen bent pins, making the 
system flakey. 

105. Keep telephone bells away, which 
are bulk erasers. 

More than 50 volts shoot into a 
telephone bell's electromagnet. It's a 
strong magnetic field, and can act as a 
bulk eraser for disks sitting under them. 
Keep phones 'way back on the desk. 

106. Keep out of Xray at airports; 
hand check disks and tape. 

Xrays are damaging to magnetic mat- 
erials. When going through an airport 
check, keep all your disks and tapes under 
your arm. Don't check them with your 
luggage, and don't let them go through the 
carry-on luggage conveyor belt Xray device. 
Insist on a hand check for those items. 

107. Attach cables correctly. 

Make sure all cables are correctly in 
place. Mark disk cables (the worst culprit) 
with 0, 1, 2 and 3, as well as 'top' and 
'bottom'. Mark the expansion cable the 
same way (the metal wire or blue stripe is 
to the left, smooth side up). Mark all 
peripherals, particularly those which re- 
quire power from the expansion box. 
Also, be sure the cassette cables are 
incorrectly (see #63 above). 
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108. Attach cables with power off, no 
matter who says what. 

Occasionally, a manual may say some- 
thing about turning the computer on, then 
attaching the cables. This is dead wrong. 
Correctly designed peripherals are always 
connected with the power off. If it is a 
construction project, avoid it; there's 
something wrong with the author's judg- 
ment. If it is a commercial product, return 
it; it shows poor design sense. 

109. Disconnect power especially 
during summer. 

High transient voltages can be present 
over the power and telephone lines during 
electrical storms. If your area is prone to 
electrical storms, keep your system un- 
plugged — not just turned off. Also, 
disconnect direct-connect modems which 
can carry high voltages straight through to 
the rest of the system. 

110. Obtain a static- free mat for 
computer and peripherals. 

In dry climates, static buildup is 
common. A static zap can: change 
memory contents; damage memory; glitch 
a disk or cassette write; glitch a load; 
crash a program; reboot the system; or 
simulate just about any crash your system 
might be sensitive to. Obtain a static-free 
mat, or line your table with aluminum foil, 
and discharge to it — don't touch your 
computer first. 

111. Keep temperature 55 to 80 
degrees, relative humidity 50 to 80 
percent. 

This is simply good practice; although 
my computer is used in 40 degrees or 
below, disk reliability is lessened. Dry 
weather (low humidity) encourages static 
(see #110), and wet weather encourages 
corrosion (see #104). 

112. Test homebrew devices before 
installation. 

There is very little more to say; always 



'proofread' your circuit with a second 
person, no matter how exhausting it may 
seem. It will prolong the life of your 
computer, and the homebrew device might 
even work the first time. 
What are the chances that your problem 
will be one of these? Probably, the 
difficulty will be a combination. This list 
is derived from work on hundreds of TRS- 
80 system combinations and relatives. 
Virtually every suggestion has been made 
and every cure implemented. Sometimes 
the problems were multiple: one unit 
suffered from salt air, bent pins, corroded 
connectors, unbuffered cables, slow 
memory, and a bum program. Another was 
the victim of modifications made with a 
Boy Scout woodburning kit instead of a 
soldering iron. 

Even if your problem is not included 
here, these suggestions should give you a 
clue about where and how to begin looking. 
Use the Radio Shack technical manual 
diagnostic chart — but don't believe the 
'ROM is bad' section, because I've never 
seen a bad ROM. Instead, suspect a bus 
driver difficulty (Z22, 38, 39, 55, 75 and 
76 in the keyboard). Otherwise, the 
manual will give you a good start on the 
tough stuff. 

Last Thoughts 

The solons at Radio Shack have done 
something very impressive: they have 
created a popular personal computer. 
From it have come the Models II and III, 
the Pocket Computers I and II, the Color 
Computers, the Model 16 is on the way, 
and a host of engineers across the world 
have been encouraged to come up with 
TRS-80 compatible hardware and soft- 
ware, and even full computer improve- 
ments like the LNW-80. 

But they have done something unwit- 
tingly even more special: they have, 
through strict and strange corporate 
policies, challenge users to create the 
Custom TRS-80. Because computers 
become appliances more and more each 
day, there will only be one Custom TRS- 
80 .. . the humble Model I. 
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INDEX 



* indicates discussion of topic 

# indicates a program listing 

$ indicates a schematic diagram 

*A* 

abbreviations *17-18 

AC 97,163-164 

access, sequential 203 

access time 87,222,245 

accumulator 38 

accuracy, floating point 246 

A/D — see analog- to- digital 

address 23,24,40,42 

— absolute 135 

— bus 24,199-201 
addresses 

— 0050 lookup table 55 

— 0066 interrupt vector 27 

— 0075 re-entry point 26 

— 01C9 screen clear 28,*36-39 

— 01FE tape drive on 79 

— 02B2 cassette entry 78 

— 03 E3 keyboard scan *53 

— 0674 initialization 25 

— 06CC Level II re-entry 27,37 

— 1987 syntax error 29 

— 1A19 Level II re-entry 29 

— 1BB3 user input 117 

— 1D5A interpreter entry 71-72 

— 1D78 interpreter loop 62 

— 1E5A integer conversion 78,117 

— 28 A7 display routine 29,117 

— 3 COO video memory 38,61 

— 37E0-37EF mapped I/O 26,27,137,139,176 

— 3840 keyboard memory 26,53 

— 4000 patch points 25 

— 4012 interrupt vector 137,217 

— 4199 disk entry area 27 

— 42E9 start of program 28,117 
addressing 

— indexed 119 

— high-resolution graphics 143,148 

— peripheral 51 
AGC 96,98 
alpha decay 232 
ALPS keyboard 253 
Alternate Source, The 135 
ALU — see arithmetic logic unit 
AM radio 147 

analog 19,170 

analog- to- digital *164-166 

animals, furry 231,255 

Apparat 112,205 

appliances 231,242 

arithmetic 24,57 

arithmetic logic unit 23 

architecture 23,24,53 

arrows 1 1 

ASCII 53-55,67,73,138,177 



assembly programming 116 
audio 156-158 
autoexecution 71, #71 

*B* 

B-17 loader 213 

Bach, Johann Sebastian 173 

bandwidth 96 

bank select *189-193,$190-191,#193 

Barden, William 119 

bases, numeric 32 

BASEX 154 

BASIC 19,36,37,40,57,62,65,71,115 

— programs 28 

— ROMs 22,24,38 
battery eliminators 13 
baud 203,212,213 
BCD 36 

beep 58,#59 

Beta-80 tape system 212 

bidirectional 136 

binary 21,24,*32-34,35,36,79,178 

— digit 24 

— division 36 

bit 24,33,65,77,203 

— storage cost per 204 
black box 19,35 
Boolean algebra 34 
bootstrap 27,152 
break (function) 141 
break (key) 26,56,73,78 
bridges, solder 107 

buffer (hardware) 35,44,129,136,166,170,177, 
178-179,222 

— inverting 178 

buffer (software) 59,137,138,155 

buffered cable 15,91,122-124,244 

buffering 42 

bugs 242 

bus 23,44,135,187 

bus wire 10 

busy 177 

bypass capacitor 15,122,227 

byte 25,33,65,78,205 

BYTE 118,119 

*C* 
cable 

— buffered 15,91,122-124,244 

— cassette 250 

— disk 248 

— interconnect 244,256 

— keyboard 21,22*229 

— multiconductor 17 

— rainbow 17 
capacitor 10,11,13,109 

— bypass 15,122,227 

— electrolytic 13 

— for video twitch 254 

— variable 11 

cartridge, eight-track 217*219-221 
cassette 42,58,130,132,203,211-212 
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— alignment 249 

— cleaning 249 

— diagnostic 238 

— hardware description *156-158 

— input/output (software) *78-83 

— maintenance 235,249-250 

— output circuitry *48-49,$49 

— relay replacement 142,249,250 

— reliability 203 

— XRX modification 111,250 
central processing unit 22,23,24,27,42 
character generator 42,46,146,254 
chassis ground 11 

checksum 80,213 

CHR$ 64,66,75,107,131 

cleaning *86 

CLEAR 40 

CLOAD 67,71-72,182 

clock 

— flip-flop 35 

— CPU master *42,$42, 134, 136 

— high- re solution 146 

— high-resolution 146 

— real-time 121 ,*182-188,$183,$185-186, 
#183-184,#187,#188-189,#192-193 

— speed increase 110-112,$110,$112 
clock-calendar 184-189 

cloning 161 
CLS *36-39,#39 
CMD 137 
cold start 153 
color codes *17 
Color Computer 41,143 
common ground 11 
comparator 222 
compiler 154 
composite video 96,104 
condition code 38 
conditions 70 
contact 

— keyboard 

— cleaner 99 
control codes 55 
conversions, numeric 32 

— hexadecimal 73 

converters — see digital-to-analog 

— see analog-to-digital 
cosmetics *96 
counter (hardware) 36 
counter (software) 54 

CPU — see central processing unit 

Craig tape deck 221 

crash 121,122,124,192,229,232 

crystal 11,146 

CSAVE 67,157,182 

CTR-41 tape deck 142,211 

CTR-80 tape deck 249 

custom interpreter 62,#62 

cutters 8 



*D* 

D/A — see digital-to-analog 
damage 85-86 
data 24 
- bus 24,199-201 

— separator 246 

— sheets following 36 
debouncing 58, #59 
decimal numbering 32 

decoding 35,42,110,121,167,170,177 

decrement 38,118 
demultiplexer 48 
derating, temperature 123 
despooler 138 
diagnostic routines 236-239 
Digi-Key Corporation 127,184 
digital delay line 126,251,252 
digital logic *34-36 
digital-to-analog 164,171,173 
dimmers, light 254 
DEM connector 98,123 
diode 10,11 
DIP 45,214 

— shunt 90,252 

— switch 90,179 
dirt 248 

disk 

— alignment 247 

— BASIC 25 

— cleaning 247 

— controller 206-207 

— drive 19,26,27 

— floppy 204 

— maintenance 236,246 

— quality 246 

— reliability 203 

DOS 40,63,137,141,205,248 

— descriptions 209 
dots 46,104,143-151 
drills, hobby 94 
drive select signal 206 
Dust- Off 99 

Dvorak keyboard 76,94 

dynamic memory 44,45,77,87,200 

*E* 

earth ground 1 1 

edge card connector 12,23,43,121,122,131,136, 
♦175*187,235,243-244 

— cleaning *233,247 

— plating 243-244 

edge connector (female) 127,187 

editing 58 

Editor/ Assembler *60-61 

— video driver modification #66-67 
EDTASM — see Editor/Assembler 
eight-track mass storage *217-228,$222-224, 
#225-228 

Electric Pencil 98,109,116,131,136 
electronic music — see music 
enable 104 
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Engineer's Notebook 10,13,164 
ENTER key 28 
envelope 170-174 
EPROM 112,152 

— bank select *189-193,$190-191,#193 
error 58 

— checking 155 

— checksum 80,213 

— L3 error 28,62 

— OM error 29,64,90 

— SN error 29,62,64,68,74 

— soft 232 

— tape 203-204 
Exatron 233 

Exatron Stringy- Floppy 83,123,167,204*210-211, 
213,217 

— maintenance 236 
exclusive OR 179 
execution routine 155 

— auto71,#71 
expansion interface 20,121 

— bus 187 

— clock speed-up 126 

— memory expansion *91 

— opening *124-126 

— reset modification *9 1-92,252 
extension cords 231 

*F* 

Farad 17 

Fastload tape system 203*211-212 

FDC — see floppy disk controller 

file (metal) 8,244 

filter, low-pass 49 

filtering 14,164,242 

flip-flop 35,36,183 

floating point accuracy 246 

floppy disk controller 26,27,205*206-207 

fluorescent lights 231 

flux — see solder, flux 

formatting, eight-track 225 

form-feed 70 

FOR-NEXT 38,40 

FORTH 154 

FORTRAN 115,154 

front panel *199-201,$201 

functional schematics 12 

furry animals 231,255 

fuse 242 

*G* 

garbage collection 241 
gates *34-36 

— AND 34 

— Exclusive OR 179 

— NAND 35,141,142 

— NOR 35 

— OR 34,38,179 

— TTL diagrams following 36 
gold plating 243 

GOSUB 36,37,40 



GOTO 36,37 

graphics characters 65 

graphics, high- re solution *143-151,$144-146, 

$147,#149 

Gray code 36 

grommets 2 1 

ground 11*89,123,242 

Gunn, David 167 

*H* 

HALT diagnostic 237 
hardware 

— description 42 
head, read/write 206 
heartbeat 25 
hexadecimal 18,66 
high-level language 115 
high-speed 

— diagnostic 238 

— laders 213 

— see also clock, speed increase 
Hobbyworld Electronics 184 
Hofstadter, Douglas 65 

home- cursor 70 
hook 63 
hot chassis 97 
house current 14,19 
humidifier 231 

*I* 

I/O — see input/output 

increment 38,80,118 

index 

— hole 205 

— pulse 206 
indexed addressing 119 
initialization 137,225 

— see also power-up 
INKEY$ 27,47,53,58,59,75-76 
input 19,162 

— diagnostic 237 
INP 177 
INPUT 28,78 
input/output 20,24 
instruction 23,167 

— AND 26,53 

— CALL 26,37,78-79,135 

— DI 25,27 

— DJNZ 26 

— EI 137 

— HALT 91,141 

— IM0, IM1, IM2 135-136 

— JUMP 37 

— LDIR 25,27 

— NOP 141 

— OR 28 

— RLC 53 

— RRA81 

— RST 28,56,135 

— XOR 25,53,80 
integrated circuit 12,13,19 

— families 13 
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— handling *89 

— pins 33 

interfacing 162-164,$163,170,*179-181,$180 

— printer *175-177 

— synthesizer *166-174 
interpreter 24,58*62-65,78*154-155 

— custom #62 

interrupt 25,27*134-140,183,217 

— diagnostic 

— modes 136 
inverter 35 

•J* 

Jameco Electronics 98-99 

jitter 147 

jumpers, programming 22 

*K* 

KBFIX 99,117,253 
keyboard 58,130,132 

— additional *93-96 

— cable 21,22,88,*229-230 

— cleaning 99,253 

— comparison (photos) 105 

— debouncing #59,99 

— display routine #55 

— general description 24,42 

— hardware description *46-47,$46 

— hexadecimal *98-102,$101 

— lockout 86 

— matrix 38 

— PEEK process 75 

— scan *53-56 
keyboard (CPU) unit 143 

— memory expansion 89-90 
keybounce 131 

— see also debouncing, keyboard 
keycaps 99,235 

— lifting tool 99 

*L* 

Lab Service Inc. 142 

label 61 

Lancaster, Don 98 

latch 36,48, 121, 166-167,$166, 199-201,$201 

leap year 184 

LED 87-88,100,162,199 

— infrared 214 

— power 230 

— tri- color 112 

Level I 22,38*40-41,42,112 

— combined with Level 11*112-114 

— ROMs 47,89,152 

Level 1122,24,28,37,38*40-41,42,57,58,63,66, 
136,139,189 

— combined with Level 1*112-114 

— in PMC-80 129 

— interconnect cable 91,98 

— ROMs 48,$48,68,98,111,152 

— ROMs, two- chip 111,113 
Level III 25*40-41,62, 182,209 



Lien, David 112 
lightning 232 

— arrestor 243 
Lindsly, Jerry 120 
line numbers 115 

linear predictive coding 169 

lines, high-resolution 148, #149-150 

LISP 154 

LIST 68 *70 

LLIST 70,138,175 

LNW 15,92,126 

— expansion board *126-129,252 

— LNW-80 132 
loaders, special 81-83 

lowercase 56,58-60,#59-60,*106,$106,254 

— see also uppercase, video memory 
low-level language 115 

LPRINT 64,65,138,175 
LSI 89,121 
lubrication 247 

*M* 

machine cycle 141,167 

machine language *36-39,40,66-69,135,212 

— instruction 167 see also instruction 

— monitor 72-73,#72-74,153,#154-158 
magnets 256 

maintenance of system 235-236 

mass storage *203-228,$216,$222-224,#213-216, 

#217-219,#225-228 

mathematic functions 58 

measurement 161 

memory 24 

— bank select *189-193,$190-191,#193 

— conservation of 116 

— crashes 121,244-245 

— dynamic 44,45,77,87,122 

— expansion *86-91 

— map 24,*38-39,189,192 

— map, high- resolution 148 

— map table 39 

— mapping 26,184 

— older 245 

— slow 244 

— write- protected 192 

— speed (access time) 87,222 

— test 77,#74-76 

memory sidecar 192,$194-195,196,#197-199 
MEMORY SIZE? 25,28,29,36,61,64,81,90,113, 
124,142,153,233,241 

— resetting *74 

— setting 29,*40 
microphonics 91,122 
microprocessor 23,152,199 
Microsoft 114 
Microtek 15 

mode (interrupts) 135-136 

monitor (hardware) *199-201,$201 

monitor (software) - see machine language monitor 

monitor, power supply 242 

monitor, video 122 

— see also video monitor 
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motor 162,205 

— stepping 204 
multiconductor cable 10 
multimeter 9 
multiplexer 36 
multiplexing 42 

music *166-174,$166-167,$170-$172,#169, 

#171-174 

*N* 

nanofarads 15 

nanoseconds 87 

National Parts 23 

nesting 155 

NEW 58,*73-74,#74 

NMI*135,141 

noise 15,91,122,123,129,233 

non-maskable interrupt 135 

number systems *31-34 

numeric conversions 57 

nut driver 8 

*0* 

ohms 13,17 

OPEN 73 

open- collector 162,$ 163,1 72 

opening the computer 21,*87-88 

opening the expansion interface *124-126 

operand 61,119 

operational amplifier 222 

opto-isolator 254 

oscilloscope 9,157*234-235 

OUT 103-105,111-112,114,173,177,192 

output controls *48-50,162 

— diagnostic 237 

*P* 

package 24,33 

packing 66 

pad 12 

paint 96 

PAIA 169 

paper tape reader *214-217,$216,#217-219 

parentheses 38 

patch point 63,116 

PEEK 65,75-76,177,232,241 

peripheral 169 

— interface, programmable 171,179 
Personal Micro Computers Inc. 129 
phantom bit 107 

phase-shift 50 
piggyback 

— integrated circuits 103,106-108,111,113 

— sockets 93 
pin numbers 12 

— diagrams, TTL following 36 

— how to read *33 
pins, bent 245 
pixel, 143 

pliers 8 

PMC-80 *129-134 

POKE 65,66,108,149,177,232,241 



polarity 13 

polling 136 

Poor Man's Floppy — see TC-8 

port 170,179,192 

— 'port FE' 49 

— 'port FF' 25,49,59,78-80,177 
power 11 

— cables 242 

— drains 242 

— strip 231 

— see also power supply; AC; house current; 
voltage 

power supply 12,*13-16,$13-16,22,42,50,89,121, 
132,147 

— clock $186 

— high-resolution graphics $145 

— problems 233 

— synthesizer $171 

— transistor 251 
power-up 256 

— monitor 153 

— routines *25-29,57 
pressure pad 205-206 
PRINT 64,65,68,108 

printer 19,58,64,121, 139,*175-177,$176 

— diagnostic 238 

— maintenance 235,255 
probe, oscilloscope 234 
program counter 118,135 

pullup, pulldown — see termination 

*Q* 

Qwerty 76,98 

*R* 

Raeco 214 
rainbow cable 15 
RAM 38,42 

— damaged 86 

— dynamic 44,87,232 

— expansion 86-89 

— reserved 38,53 

— static 192,232,257 

— using 4K for expansion 127 

— video 45,106 

— write-protected 192 

— see also memory, dynamic memory, ROM 
READ 69,246 

read circuitry diagnostic 237 

read-only-RAM — see RAM, write-protected 

read/write 42,205 

READY 27,37,72,91,113,141,211 

recording 156 

reference manuals 23 

refresh 42,44,86,122,152,200 

registers 23,37,119 

— control 188 
regulation 12*13-16 
regulators 12 
relative branch 118 
relative subroutine 119 
relay, cassette 142,249 
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reliability, tape 78-83,203 
relocatable code *1 15-120 
REM 65,70 
repeating keys 58,#59 
reset button 92,135,141 

— expansion modification *91-92 

— keyboard modification *92-93,252 
resistor 10,11,12,13 

— termination 15,92,123,128,251,252 

— variable 11 
restart 114 

reverse video *103-105,$103 

RFI (radio frequency interference) 255 

RF modulator 50,96*98,130,132 

rollover 54 

ROM 38,40,42,60,68,98,116,120,131,138 

— bank select *189-193,$190-191,#193 

— control *47-48 

— Level 1*112-113 

— replacement *152,$152 
RPGII115 

RS-230 121-123,246 

— maintenance 235,246 
RUN 71 

*S* 

salt water 231,256 

Sams publications 10 

scalpel 8 

schematics *10-12 

Schmitt trigger 162 

scratches 96 

screwdriver 8 

Scripsit 131 

scroll 136-137 

sector 205 

sensor, foil 222 

serial- to-parallel conversion 79,157 

serialization 156 

servicing interrupts *135-140 

shield 14 

— RFI 255 

shift key 54-55,95 

shift register 36 

shock hazard 97 

shockproofing (vibration) 123,232 

shunt 45*90,252 

signal 34,200 

signalling 161 

signals 

— BLANK 46 

— CAS 44,45,122,126,153,245 

— DAL0-DAL7 207 

— HALT 135 

— HDRV 50 

— IN 43,153,222 

— INSIG 48,49 

— INT 47,135,182,215 

— INTAK215 

— INTRQ 207 

— IORQ 43 



— KYBD 46,47 

— MEM 47 

— MREQ 43,111,122 

— MUX 44,45,122,126,153,245 

— OUT 43,103,153,222 

— OUTSIG 48,49,78 

— RAS 45,122,126,141,153,245 

— RD 43,111,153,177 

— RESET 43 

— RFSH 44 

— SYSRES 114 

— TEST 44,153 

— VDRV 50 

— VID 45,47 

— WR 43,45,153,177,192 
Silver-It 86,243 

slash 80 

smearing, video 98 
smoke 231 
socket 89,121,124 
soft error 232 
solder 9 

— braid 9 

— bridges 107,252 

— flux 52,86,107 

— iron 8,52,89 

— /silver 86 

— technique *52 

— wick 9,106 
solder joints, cold 252 
soldering iron grounding 89 

sound #67-69,*166-174,$166-167,$170-172 

— effects 70,#70,*169-173 
spacers — see grommets 

speed increase, CPU — see clock, speed increase 

speed of execution 116-118 

spikes 14 

splice, tape 219 

spooler 138,#139 

stack 40,138,241 

static 89,184 

static-free workbench 89,257 

start bit 79 

stepping motor — see motor, stepping 

storage 157 

string 40,58 

— packing *66-69 

Stringy- Floppy — see Exatron Stringy-Floppy 

subroutines 116,118 

switch box, cassette 250 

symbol table 61 

symbols *10-12 

sync (harware) 42,50,96 

sync (software) 79 

synchronization 

— oscilloscope 234 

— power line 182 

— process 79 
syntax 155 
synthesizer *169-174 
SYSTEM 71*78-80.116 



264 



•T* 

tape, cassette ■— see cassette 

tape, paper — see paper tape reader 

TC-8 tape system *211-212 

Technical Referece Handbook 12,23,42,44-47,50, 

78,106 

telephone 

— bells 256 

— communications 19 
Teletype 139 

television 50,96*98,130,132,231 

temperature derating 123 

termination resistor 15,123,128,251,252 

text editing 136 

Thermo-Fax belt cleaner 107 

TIMES 182-183 

tinning 230 

token 62*63-65,154 

tolerances *12-13 

tone color 169 

tools *8-10 

TPR-1 paper tape reader *2 14 -2 17 

traces 19 

transformer 11 

transistor 10,11 

transitions 70 

trigger (envelope) 171 

trim erase 204 

trimpot 107 

TRS-80 

— Color Computer 41 

— general description *19-21 
truth table 34 

TTL 122,162 
turnkey system 23 
tweezers 8 
twisted pair 122,245 

*U* 

UART 129 

uppercase 56,58-59, #59-60 

— see also lowercase, video memory 
USR68 

*V* 

variable (resistor, capacitor) 11 

variables 40,58,155,241 

— string 66 
VARPTR 66-69,241 
VCO 172 

vector 63,116 
vibration 123,232 
video 25,38,58,130,136 

— alignment 235,254 

— buffer 253 

— composite 96,104 

— countdown chain 146 

— description 24,42 

— diagnostic 237 

— driver routine #63-66 

— in PMC-80 132 

— monitor, description 103 



— monitor, additional *96-98,$97 

— output circuitry *50,$50 

— RAM (memory) 45,46,65,106,143 

— reverse (complete screen) *103-105,$103 

— reverse (individual characters) *106-110 

— scan (beam) 143 

— tear 253 

— twitch 253 

voice input/output 19,#81-82,$83 

volt 17,162 

voltage 

— control 172 

— isolation 162 

— levels 24,164 

— power supply 12 
Votrax 169 

*W* 

wafer 204 
warm start 153 
Watt 17 

waveform 80,169 
wire, bus 10 
wire- wrap 

— socket 93 

— technique *51 

— tool 8,51 

— wire 10,51 

write circuitry diagnostic 236 
write enable 206 
write-protect (disk) 204,206 
write-protect (memory) 192 

•X* 

X-acto knife 8,96,106,107 
X-ray danger 256 
XRX modification 111,250 
X3 (shunt) — see Z3 
X71 (shunt) — see Z71 

*Y* 

•Z* 

Z3 22,47,90,113,252 

Z71 22,45,90,252 

Z-80 22,37,53,60,89,117,141,167 

— block diagram 23 

— handling 89 

— interrupts * 134- 140 

— signals 43 

— technical manual 135 
Z80A251 
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Appendix I 
Parts Suppliers 



The Four Stars 

Digi-Key Corporation, Hiway 32 South, P.O. 
Box 677, Thief River Falls, MN 56701. 800 346- 
5144. COD, check, money order, credit cards. 
Volume discounts over $100; shipping, insurance 
prepaid. 

This company is in my opinion the 
hobbyist's best. Shipping is fast (five days 
from ordering to my door in Vermont), and 
most items are in stock. Their catalog is 
monthly, and items not stocked are not 
listed. All merchandise is prime; no 
bubble packs. 

QT Computer Systems, 15335 S. Hawthorne 
Blvd., Lawndale, CA 90260. 800 421-5150. COD 
under $100, check, money order; credit cards 
preferred. Quantity discounts, no insurance. 

A good hobbyist catalog similar to Digi- 
Key, with competitive prices. This is a 
new company, but they are already 
beginning to make a mark for promptness, 
exceeding courtesy, and prime parts. Their 
catalog is very complete and quite up-to- 
date. 

Advanced Computer Products, 1310 E. 
Edinger, Santa Ana, CA 92705. 800 854-8230. 
COD, check, money order, credit cards. Volume 
discounts, no insurance. 

One of the best catalogs in the business, 
prompt, but be wary of substitutions in orders. 
Specify voltages of devices and check upon 
receipt. Expect harrassment from Customer 
Service. Otherwise, they have what you can't 
get anywhere else. 

Jameco Electronics, 1355 Shoreway Road, 
Belmont, CA 94002. 415 592-8097. COD, check, 
money order, no credit cards. No discounts, no 
insurance. 

One almost wonders why to put Jameco in 
with the four best, but their selection is 
contemporary and their response prompt. 
They have items others don't have in stock for 
the popular computer hobbyist. Bubble pack 
stuff on retail store racks at Lafayette Radio 
and others. Highest prices in the business. 



And Others 

Jade Computer Products, 4901 West 
Rosecrans Ave., Hawthorne, CA 90250. 800 421- 
5500. No CODs; checks, money order; credit 
cards preferred. Quantity discounts; insurance 
under 50 lbs. 

This company works hard at immediate 
hobbyist needs and some unusual items. Get 
their catalog, but consult monthly ads in 
electronics magazines for hot items. 

Priority One Electronics, 16723C Roscoe 
Blvd., Sepulveda, CA 91343. 800 423-5633. No 
CODs; check, money order, credit cards. 
Quantity discounts, insurance. 

Priority deals for the most part in larger 
items for computer hobbyists, with only a 
token selection of small parts. This company 
concentrates on boards and naked disk drives, 
and heavier hardware. 

Hobbyworld Electronics, 19511 Business 
Center Dr., Northridge, CA 91324. 800 423-5387, 
(800 382-3651 in CA). COD ($1.25 extra), check, 
credit cards. No discounts, no insurance. 

Hobbyworld is the computer hobbyist's pop 
culture. It stocks all the hot items with a high 
turnover. Look to them for low prices on items 
you need right away. 

Electrolabs, P.O. Box 6721, Stanford, CA 
94305. 

The best part is always their funny and 
schizophrenic catalog with an honest 
selection and a wealth of good information. 
For example . . . 

"Save yourselves $6.75 and use a 25 cent 
transistor the next time your looking for a 
temperature probe." Also, TTL Family rules 
of Incest are great.) The shipping was always 
prompt and the merchandise prime. 

Not Recommended 

Active Electronic Sales, P.O. Box 1035, 
Framingham, MA 01701. 617 879-0077. 
Minimum $10, handling $2, check (wait to 
clear), money order. No discounts, no 
insurance. 

This group claims to be "The World's 
Largest International Semiconductor 
Distributor", which implies lots of stock, in 
stock. No way. All my orders have been 
returned 25 percent filled, with 50 percent 
errors. 
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Appendix II. 
Bibliography. 



Reference Books 



Manuals, Guides, and Data Books 



Radio Shack, Tandy Corporation. Forth Worth, 
Texas. 

TRSDOS & Disk BASIC Reference Manual, 
1979. 

TRS-80 Micro Computer Technical Reference 
Handbook, 1978. 

Printer Interface Cable, Service Manual. 

Expansion Interface, Service Manual. 

TRS-80 16K RAM Expansion, Service 
Manual. With Addendum. 

National Semiconductor, 2900 Semiconductor 
Drive, Santa Clara, California 95051. 

TTL Databook, 1975. 

Memory Databook, 1977. 

CMOS Databook, 1977. 

Series 8000 Microprocessor Family 
Handbook, 1978. 

— Special Functions Databook, 1979. 

— Linear Data Book, 1976. 

— Linear Applications, Volume 1, 1973. 

— Linear Applications, Volume 2, 1977. 

— Voltage Regulator Handbook, 1975. 

— Pressure & Temperature Transducers, 
1974. 

Motorola, Inc. The Complete Motorola 
Microcomputer Data Library. Technical 
Information Center, Box 20912, Phoenix, 
Arizona 85036. 1978. 

Pro-Log Corporation. Microprocessor User's 
Guide. 2411 Garden Road, Monterey, California 
93940. 1980. 

Zilog, Inc. Z80-CPU / Z80A-CPU Technical 
Manual. 10340 Bubb Road, Cupertino, 
California 95014. 1977. 



Jonathan A. Titus, Christopher A. Titus, and 
David G. Larsen, TRS-80 Interfacing. Books 1 
and 2. Each 250 pp. Howard W. Sams and Co., 
Inc., 4300 West 62nd St., Indianapolis, Indiana 
46268. 1979, 1980. 

Sybex, 2020 Milvia Street, Berkeley, California 
94704. 

Rodnay Zaks, Microprocessors, from Chips to 
Systems. 416 pp. 2nd ed., 1977. 

Rodnay Zaks, Programming the Z80. 624 pp. 
1979. 

Austin Lesea and Rodnay Zaks, 
Microprocessor Interfacing Techniques. 416 
pp. 2nd ed., 1978. 

William Barden, Jr., The Z-80 Microcomputer 
Handbook. 304 pp. Howard W. Sams and Co., 
Inc., 4300 West 62nd St., Indianapolis, Indiana 
46268. 1978. 

William Barden, Jr., TRS-80 Assembly 
Language Programming. 224 pp. Radio Shack, 
Fort Worth, Texas. 1979. 

Adam Osborne, Jerry Kane, Russell Rector, and 
Susanna Jacobson, Z80 Programming for Logic 
Design. Osborne and Associates, P. O. Box 2036, 
Berkeley, California 94702. 1978. 

Jim Perry and Chris Brown, eds., 80 Programs 
for the TRS-80. 234 pp. 1001001 Inc., 
Peterborough, New Hampshire 03458. 1979. 

John Blattner and Bryan Mumford, Inside Level 
II, A Programmer's Guide to the TRS-80 ROMs. 
65 pp. Mumford Micro Systems, Box 435, 
Summerland, California 93067. 1980. 

H. C. Pennington, TRS-80 Disk and Other 
Mysteries. IJG Computer Services, 1260 W. 
Foothill Blvd., Upland, California 91768. 1979, 
1980, 1981. 

James Farvour, Microsoft BASIC Decoded and 
Other Mysteries. IJG Computer Services, 1260 
W. Foothill Blvd., Upland, California 91768. 
1981. 

David A. Lien, User's manual for Level 1. 232 
pp. Radio Shack, Fort Worth. 1978. 

W. J. Weller, Practical Microcomputer 
Programming: The Z80. 480 pp. Northern 
Technology Books, Box 62, Evanston, Illinois 
60204. 1978. 

Thomas C. Mclntire, Software Interpreters for 
Microcomputers. 233 pp. John Wiley and Sons, 
New York. 1978. 
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Robert Richardson, Disassembled Handbook for 
TRS-80. (In continuing volumes; 1, 2 and 3 
published to date). Richcraft Engineering Ltd., 
Drawer 1065, Chautauqua, New York 14722. 
1980. 

Forest M. Mims, HI, Engineer's Notebook: A 
Handbook of Integrated Circuit Applications. 
128 pp. Radio Shack, Fort Worth, 1979. 

Paul Warme, BASEX: A Simple Language and 
Compiler for 8080 Systems. With TRS-80 
addendum. 97 pp. BYTE Books, 70 Main Street, 
Peterborough, New Hampshire 03458. 1979. 

Forth, Inc., Microforth Primer. FORTH, Inc., 
815 Manhattan Avenue, Manhattan Beach, 
California 90266. 1978. 

Hal Chamberlin. Musical Applications of 
Microprocessors. 660 pp. Hayden Book 
Company, Inc., Rochelle Park, New Jersey. 
1980. 

Wayne Bateman, Introduction to Computer 
Music. 314 pp. John Wiley and Sons, New York. 
1980. 

G. Michael Schneider, Steven W. Weingart, and 
David M. Perlman, An Introduction to 
Programming and Problem Solving with Pascal. 
394 pp. John Wiley and Sons, New York. 1978. 

Periodicals and Irregulars 

80 Microcomputing. 80 Pine St., Peterborough, 
New Hampshire 03458. $18 per year. 

Kilobaud Microcomputing. 73 Pine St., 
Peterborough, New Hampshire 03458. $25 per 
year. 

BYTE. 70 Main St., Peterborough, New 
Hampshire 03458. $19 per year. 

onComputing. 70 Main St., Peterborough, New 
Hampshire 03458. $12 per year. 

80-U.S. Journal. 3838 South Warner Street, 
Tacoma, Washington 98409. $24 per year. 

Softside. 6 South Street, Milford, New 
Hampshire 03055. $24 per year. 

Popular Electronics. One Park Avenue, New 
York, New York 10016. $14 per year. 

The Alternate Source. 1806 Ada Street, Lansing, 
Michigan 48910. $12 per year. 

Radio Electronics. 200 Park Avenue South, New 
York, New York 10003. $9.98 per year. 

CLOAD. P.O. Box 1267, Goleta, California 
93017. $42 per year, on cassette. 

Fairfield County Users Group, Voice of the 80. 
C/O Alan Abrahamson, 10 Richlee Road, 
Norwalk, Connecticut 0685L 



Marin County TRS-80 Users Group Newsletter. 
P.O. Box 895, Novate, California 94948. 

Computer Base Lubbock. C/O Roger Smith, 
2601 Nonesuch Dr., Lot 1802, Abilene, Texas 
79606. 

TCS, Club Project of the Tidewater TRS-80 
Users Group. P.O. Box 10281, Norfolk, Virginia 
23513. 

Northern Bytes. Micrcomputer Users 
International. C/O Jack Decker, 1804 West 18th 
Street, Lot 155 Sault Suite. Marie, Michigan 
49783. 

Orange Country TRS-80 Users Group 
Newsletter. C/O Ed Faulk, 2531 E. 
Commonwealth, Fullerton, CA 92631. 

The Bit Bucket. Texhoma Microcomputer 
Enthusiasts, P.O. Box 1384, Wichita Falls, 
Texas 76301. 

Amateur Computer Group of New Jersey News. 
UCTI, 1776 Raritan Road, Scotch Plains, New 
Jersey 07076. 

Delaware Valley Computer Club Newsletter. 
P.O. Box 651, Levittown, Pennsylvania 19058. 

Cleveland Digital Group, TRS-80 User's Group 
Newsletter. C/O Cleveland Heights Public 
Library, 2345 Lee Road, Cleveland Heights, 
Ohio 44112. Or C/O 1838 Willowhurst Ave., 
Cleveland, Ohio 44112. 

Chicatrug News. Chicago TRS-80 Users Group. 
Emmanual B. Garcia Jr., and Associates, 203 N. 
Wabash, Room 2102, Chicago, Illinois 60601. 

Thought and Relaxation 

Frederick P. Brooks, Jr., The Mythical Man- 
Month: Essays on Software Engineering. 
Addison-Wesley Publishing Company, Reading, 
Massachusetts. 1978. 

Douglas Hofstadter. Godel, Escher, Bach: The 
Eternal Golden Braid. Vintage Books. 1980. 
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APPENDIX 3 
Byte Values end Their Equivalents 



Code 


POKE displa 


ys: 


PRINT: 


Edtasm Standrd 


Hex 


Dec 


Without 


With 


With 


w/ LC 


Z80 i 


ASCII 


Val 


Val 



L/Case 


OLd LC 


New LC 


Driver 


Opcode Meaning 


00 


§ 


yarning 


a 


none 


NOP 


NUL 


01 


1 


A 


gaming 


A 


none 


LD BC.NN 


SOH 


02 


2 


B 


gaining 


B 


none 


LD (BC),A 


STX 


03 


3 


C 


gaming 


C 


none 


INC BC 


ETX 


04 


4 


D 


gaming 


D 


none 


INC B 


EOT 


05 


5 


E 


gaming 


E 


none 


DEC B 


ENQ 


06 


6 


F 


gaming 


F 


none 


LD B,N 


ACK 


07 


7 


G 


gaming 


G 


none 


RLCA 


BEL 


08 


8 


H 


gaming 


H 


bkspce 


EX AF,AF' 


BS 


09 


9 


I 


gaming 


I 


bksp lin 


ADD HL,BC 


HT 


0A 


10 


J 


gaming 


J 


Linefeed 


LD A, (BC) 


LF 


OB 


11 


K 


gaming 


K 


none 


DEC BC 


VT 


OG 


12 


L 


gaming 


L 


formfeed 


INC C 


FF 


OD 


13 


H 


yarning 


M 


car retn 


DEC C 


CR 


OE 


14 


N 


gaming 


N 


crsr on 


LD C,N 


SO 


OF 


15 





gaming 





crsr off 


RP.CA 


SI 


10 


16 


P 


gaming 


P 


none 


DJNZ d 


DLE 


11 


17 


Q 


gaming 


Q 


none 


LD DE.NN 


DC1 


12 


16 


R 


gaming 


R 


none 


LD (DEM 


DC2 


13 


19 


S 


gaming 


S 


none 


INC DE 


DC3 


14 


20 


T 


gaming 


T 


none 


INC D 


DC4 


15 


21 


U 


gaming 


U 


none 


DEC D 


NAK 


16 


22 


V 


gaming 


V 


none 


LD D,N 


SYN 


17 


23 


N 


gaming 


w 


wi demode 


RLA 


ETB 


18 


24 


X 


gaming 


X 


bkspcrsr 


JR d 


CAN 


19 


25 


Y 


gaming 


Y 


sdv crsr 


ADD HL.DE 


EM 


1A 


26 


Z 


gaming 


z 


dn Linfd 


LD A, (DE) 


SUB 


1B 


27 


L brace 


gaming 


up arr 


up linfd 


DEC DE 


ESC 


1C 


28 


dn arr 


gaming 


dn arr 


home crsr 


INC E 


FS 


1D 


29 


r brace 


gaming 


Leftarr 


strt crsr 


DEC E 


GS 


1E 


30 


rt arr 


gaming 


rt arr 


erase lin 


LD E,N 


RS 


1F 


31 




gaming 




clr frame 


RRA 


US 


20 


32 


space 


space 


space 


space 


JR NZ,d 


space 


21 


33 


I 


1 


! 


1 


LD HL.NN 


! 


22 


34 


n 


ii 


ii 


n 


LD (NN),HL " 


23 


35 


# 


# 


# 


# 


INC HL 


I 


24 


36 


$ 


$ 


$ 


$ 


INC H 


S 


25 


37 


% 


% 


% 


% 


DEC H 


% 


26 


38 


& 


& 


& 


6. 


LD H,N 


& 


27 


39 


i 


i 


i 


' 


DAA 


1 


28 


40 


I 


[ 


( 


( 


JR Z,d 


( 


2S 


41 


] 


) 


1 


) 


ADD HL,HL 


) 


2A 


42 


* 


* 


* 


* 


LD HL,(NN] 


* 


2B 


43 


+ 


+ 


+ 


+ 


DEC HL 


+ 


2C 


44 


t 


i 


F 


» 


INC L 


1 


2D 


45 


- 


- 


- 


- 


DEC L 


- 


2E 


46 


• 


a 


■ 


■ 


LD L,N 


■ 


2F 


47 


/ 


/ 


/ 


/ 


CPL 


/ 


30 


48 














JR NC,d 
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Code 


POKE 


display 


s: 


PRINT: 
w/ LC 


Edtasm Standrd 


Hex 


Dec 


Without 


With 


With 


Z80 


ASCII 


Val 


Val 


L/C as e 


Old LC 


New LC 


Driver 


Opcode Meaning 


31 


49 


1 


1 


1 


1 


LD SP,NN 


1 


32 


50 


2 


2 


2 


2 


LD (NN),A 


2 


33 


51 


3 


3 


3 


3 


INC SP 


3 


34 


52 


4 


4 


4 


4 


INC (HLJ 


4 


35 


53 


5 


5 


5 


5 


DEC (HLJ 


5 


36 


54 


6 


6 


6 


6 


LD [HL),N 


6 


37 


55 


7 


7 


7 


7 


SCF 


7 


38 


56 


G 


B 


8 


B 


JR C,d 


8 


39 


57 


9 


9 


9 


9 


ADD HL,SP 


9 


3A 


58 


; 


■ 


: 


: 


LD A,(NN) 


: 


3B 


59 


J 


t 


r 


i 


DEC SP 


! 


3C 


60 


< 


< 


< 


< 


INC A 


< 


3D 


61 


- 


- 


- 


- 


DEC A 


= 


3E 


62 


> 


> 


> 


> 


LD A f N 


> 


3F 


63 


? 


? 


? 


? 


CCF 


? 


40 


64 


@ open quote 


@ 


@ 


LD B,B 


e 


41 


65 


A 


A 


A 


A 


LD B,C 


A 


42 


66 


B 


B 


B 


B 


LD B,D 


B 


43 


67 


C 


C 


C 


C 


LD B,E 


C 


44 


68 


D 


D 


D 


D 


LD B,H 


D 


45 


69 


E 


E 


E 


E 


LD B f L 


E 


46 


70 


F 


F 


F 


F 


LD B.CHL) 


F 


47 


71 


G 


G 


G 


G 


LD B,A 


G 


48 


72 


H 


H 


H 


H 


LD C,B 


H 


49 


73 


I 


I 


I 


I 


LD C,C 


I 


4A 


74 


J 


J 


J 


J 


LD C f D 


J 


4B 


75 


K 


K 


K 


K 


LD C f E 


K 


4C 


76 


L 


L 


L 


L 


LD C F H 


L 


4D 


77 


M 


M 


M 


M 


LD C,L 


M 


4E 


78 


N 


N 


N 


N 


LD C, (HL) 


N 


4F 


79 














LD C,A 





50 


80 


P 


P 


P 


P 


LD D,B 


P 


51 


81 


D 


Q 


Q 





LD D F C 


Q 


52 


82 


R 


R 


R 


R 


LD D,D 


R 


53 


83 


S 


S 


S 


S 


LD D,E 


S 


54 


84 


T 


T 


T 


T 


LD D,H 


T 


55 


85 


U 


U 


U 


U 


LD D F L 


U 


56 


86 


V 


V 


V 


V 


LD D F (HL) 


V 


57 


87 


W 


w 


w 


w 


LD D,A 


W 


58 


88 


X 


X 


X 


X 


LD E,B 


X 


59 


89 


Y 


Y 


Y 


Y 


LD E,C 


Y 


5A 


90 


z 


z 


z 


z 


LD E,D 


Z 


5B 


91 


L.brkt. 


L.brkt. 


up err. 


up arr. 


LD E,E 


l.brkt 


5C 


92 










LD E,H 


slant 


5D 


93 










LD E,L 


r.brkt 


5E 


94 










LD E,IHLJ 


carat 


5F 


95 










LD E f A 


L.arr. 


60 


96 


@ Of 


en quote 


! pound 


e 


LD H,B 


undef . 


61 


97 


A 


a 


a 


a 


LD H,C 


a 


62 


98 


B 


b 


b 


b 


LD H,D 


b 


63 


99 


C 


c 


c 


c 


LD H f E 


c 


64 


100 


D 


a 


d 


d 


LD H,H 


d 


65 


101 


E 


e 


e 


e 


LD H,L 


e 
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Code 


POKE 


display 


s: PRINT: 


Edtasm Standrd 


Hex Dec ' 


Without 


With 


With w/ 


LC 


ZBO ASCII 


VaL Val 


L/Case Old LC 


New LC Driver 


Op 


code Meaning 


66 102 


F 


f 


f 


f 


LD 


H,IHL) f 


67 103 


G 


y 


& 


9 


LD 


H f A g 


68 104 


H 


h 


h 


h 


LD 


L,B h 


69 105 


I 


i 


i 


i 


LD 


L,C i 


6A 106 


J 


J 


J 


J 


LD 


L,D j 


6B 107 


K 


k 


k 


k 


LD 


L,E k 


6C 108 


L 


I 


I 


L 


LD 


L,H L 


6D 109 


M 


no 


m 


m 


LD 


L,L m 


6E 110 


N 


n 


n 


n 


LD 


L.IHL) n 


6F 111 














LD 


L,A o 


70 112 


P 


P 


P 


P 


LD 


(HL) f B p 


71 113 


Q 


q 


q 


q 


LD 


(HL],C q 


72 114 


R 


r 


r 


r 


LD 


[HL),D r 


73 115 


S 


s 


s 


s 


LD 


(HL),E s 


74 116 


T 


t 


t 


t 


LD 


(HLJ.H t 


75 117 


U 


u 


u 


u 


LD 


tHLJ.L u 


76 118 


V 


V 


V 


V 


HALT v 


77 119 


N 


w 


w 


w 


LD 


(HL),A w 


78 120 


X 


X 


X 


X 


LD 


A,B x 


79 121 


Y 


V 


y 


y 


LD 


A,C y 


7A 122 


Z 


z 


z 


z 


LD 


A f D z 


7B 123 










LD 


A F E L. brace 


7C 124 










LD 


A,H separator 


7D 125 










LD 


A^L r. brace 


7E 126 










LD 


A,{HL) wave 


7F 127 










LD 


A, A delete 






Upper 


Character 


Set 






HEX DEC 


POKE 




BASIC 


I 


3 RINT 


ZBO 


VaL VaL 


Display 




Keyword: 
END 


Display: 


Opcode : 


60 128 


/G/ 




/G/ 


ADD A,B 


81 129 


/G/ 




FOR 




/G/ 


ADD A,C 


82 130 


/G/ 




RESET 




/G/ 


ADD A,D 


83 131 


/G/ 




SET 




/G/ 


ADD A,E 


84 132 


/G/ 




CLS 




/G/ 


ADD A,H 


85 133 


/G/ 




CMD 




/G/ 


ADD A,L 


86 134 


/G/ 




RANDOM 




/G/ 


ADD A F (HL) 


87 135 


/G/ 




NEXT 




/G/ 


ADD A, A 


88 136 


/G/ 




DATA 




/G/ 


ADC A,B 


89 137 


/G/ 




INPUT 




/G/ 


ADC A,C 


8A 138 


/G/ 




DIM 




/G/ 


ADC A,D 


8B 139 


/G/ 




READ 




/G/ 


ADC A,E 


8C 140 


/G/ 




LSET 




/G/ 


ADC A,H 


8D 141 


/G/ 




GOTO 




/G/ 


ADC A,L 


8E 142 


/G/ 




RUN 




/G/ 


ADC A,(HL] 


BF 143 


/G/ 




IF 




/G/ 


ADC A, A 


90 144 


/G/ 




RESTORE 




/G/ 


SUB B 


91 145 


/G/ 




GOSUB 




/G/ 


SUB C 


92 146 


/G/ 




RETURN 




/G/ 


SUB D 


93 147 


/G/ 




REM 




/G/ 


SUB E 
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Upper Character 


Set 




HEX 


DEC 


POKE 


BASIC 


PRINT 


Z80 


Val 


VbL 
148 


Display: 


Keyword: 
STOP 


Display: 


Opcode: 


S4 


/G/ 


/G/ 


SUB H 


95 


149 


/G/ 


ELSE 


/G/ 


SUB L 


96 


150 


/G/ 


TRON 


/G/ 


SUB (HL) 


97 


151 


/G/ 


TROFF 


/G/ 


SUB A 


SB 


152 


/G/ 


DEFSTR 


/G/ 


SBC A,B 


99 


153 


/G/ 


DEFINT 


/G/ 


SBC A,C 


9A 


154 


/G/ 


DEFSNG 


/G/ 


SBC A,D 


9B 


155 


/G/ 


DEFDBL 


/G/ 


SBC A,E 


9C 


156 


/G/ 


LINE 


/G/ 


SBC A,H 


9D 


157 


/G/ 


EDIT 


/G/ 


SBC A,L 


9E 


158 


/G/ 


ERROR 


/G/ 


SBC A,[HL) 


9F 


159 


/G/ 


RESUME 


/G/ 


SBC A,A 


AO 


160 


/G/ 


OUT 


/G/ 


AND B 


A1 


161 


/G/ 


ON 


/G/ 


AND C 


A2 


162 


/G/ 


OPEN 


/G/ 


AND D 


A3 


163 


/G/ 


FIELD 


/G/ 


AND E 


A4 


164 


/G/ 


GET 


/G/ 


AND H 


A5 


165 


/G/ 


PUT 


/G/ 


AND L 


A6 


166 


/G/ 


CLOSE 


/G/ 


AND (HL) 


A7 


167 


/G/ 


LOAD 


/G/ 


AND A 


A8 


168 


/G/ 


MERGE 


/G/ 


XOR B 


A9 


169 


/G/ 


NAME 


/G/ 


XOR C 


AA 


170 


/G/ 


KILL 


/G/ 


XOR D 


AB 


171 


/G/ 


LSET 


/G/ 


XOR E 


AC 


172 


/G/ 


RSET 


/G/ 


XOR H 


AO 


173 


/G/ 


SAVE 


/G/ 


XOR L 


AE 


174 


/G/ 


SYSTEM 


/G/ 


XOR IHLJ 


AF 


175 


/G/ 


LPRINT 


/G/ 


XOR A 


BD 


176 


/G/ 


DEF 


/G/ 


OR B 


B1 


177 


/G/ 


POKE 


/G/ 


OR C 


B2 


178 


/G/ 


PRINT 


/G/ 


OR D 


B3 


179 


/G/ 


CONT 


/G/ 


OR E 


B4 


180 


/G/ 


LIST 


/G/ 


OR H 


B5 


181 


/G/ 


LLIST 


/G/ 


OR L 


B6 


182 


/G/ 


DELETE 


/G/ 


OR [HU 


B7 


183 


/G/ 


AUTO 


/G/ 


OR A 


B8 


184 


/G/ 


CLEAR 


/G/ 


CP B 


B9 


185 


/G/ 


CLOAD 


/G/ 


CP C 


BA 


186 


/G/ 


CSAVE 


/G/ 


CP D 


BB 


187 


/G/ 


NEW 


/G/ 


CP E 


BC 


188 


/G/ 


TAB( 


/G/ 


CP H 


BD 


189 


/G/ 


TO 


/G/ 


CP L 


BE 


190 


/G/ 


FN 


/G/ 


CP (HL) 


BF 


191 


/G/ 


USING 


/G/ 


CP A 


CO 


192 


/G/ 


VARPTR 


/G/ 


RET NZ 


D1 


193 


/G/ 


USR 


TAB+Oi 


POP BC 


C2 


194 


/G/ 


ERL 


TAB+02 


JP NZ.NN 


G3 


195 


/G/ 


ERR 


TAB+03 


JP NN 


C4 


196 


/G/ 


STRINGS 


TAB+04 


CALL NZ F NN 


C5 


197 


/G/ 


INSTR 


TAB+05 


PUSH BC 


C6 


198 


/G/ 


POINT 


TAB+06 


ADD A,N 


C7 


199 


/G/ 


TIME* 


TAB+07 


RST OOH 
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Upper Character 


Set 




HEX DEC 


POKE 


BASIC 


PRINT 


Z80 


VaL Val D 


ispLay : 


Keyword: 


Display : 
TAB+08 


Opcode: 


C8 200 


/G/ 


MEM 


RET Z 


C9 201 


/G/ 


INKEY$ 


TAB+09 


RET 


CA 202 


/G/ 


THEN 


TAB+10 


JP Z, NN 


CB 203 


/G/ 


NOT 


TAB+11 


<Note 1> 


CC 204 


/G/ 


STEP 


TAB+12 


CALL Z.NN 


CD 205 


/G/ 


+ 


TAB+13 


CALL NN 


CE 206 


/G/ 


- 


TAB+14 


ADC A,N 


CF 207 


/G/ 


* 


TAB+15 


RST 08H 


DO 208 


/G/ 


/ 


TAB+16 


RET NC 


D1 209 


/G/ 


** 


TAB+17 


POP DE 


D2 210 


/G/ 


AND 


TAB+18 


JP NC F NN 


D3 211 


/G/ 


OR 


TAB+19 


OUT IN), A 


D4 212 


/G/ 


> 


TAB+20 


CALL NC,NN 


D5 213 


/G/ 


- 


TAB+21 


PUSH DE 


D6 214 


/G/ 


< 


TAB+22 


SUB N 


D7 215 


/G/ 


SGN 


TAB+23 


RST 10H 


DB 216 


/G/ 


INT 


TAB+24 


RET C 


D9 217 


/G/ 


ABS 


TAB+25 


EXX 


DA 218 


/G/ 


FRE 


TAB+26 


JP C,NN 


DB 219 


/G/ 


INP 


TAB+27 


IN A,(N) 


DC 220 


/G/ 


POS 


TAB+28 


CALL C,NN 


DD 221 


/G/ 


SQR 


TAB+29 


<Note 2> 


DE 222 


/G/ 


RND 


TAB+30 


SBC A,N 


DF 223 


/G/ 


LOG 


TAB+31 


RST 18H 


EO 224 


/G/ 


EXP 


TAB+32 


RET PO 


E1 225 


/G/ 


COS 


TAB+33 


POP HL 


E2 226 


/G/ 


SIN 


TAB+34 


JP PO,NN 


E3 227 


/G/ 


TAN 


TAB+35 


EX tSP),HL 


E4 228 


/G/ 


ATN 


TAB+36 


CALL PO.NN 


E5 229 


/G/ 


PEEK 


TAB+37 


PUSH HL 


E6 230 


/G/ 


CVI 


TAB+38 


AND N 


E7 231 


/G/ 


CVS 


TAB+39 


RST 20H 


E8 232 


/G/ 


CVD 


TAB+40 


RET PE 


E9 233 


/G/ 


EOF 


TAB+41 


JP (HL) 


EA 234 


/G/ 


LOC 


TAB+42 


JP PE f NN 


EB 235 


/G/ 


LOF 


TAB+43 


EX DE.HL 


EC 236 


/G/ 


MKI$ 


TAB+44 


CALL PE.NN 


ED 237 


/G/ 


MKS$ 


TAB+45 


<Note 3> 


EE 238 


/G/ 


MKD$ 


TAB+46 


XOR N 


EF 239 


/G/ 


CINT 


TAB+47 


RST 28H 


FO 240 


/G/ 


CSNG 


TAB+48 


RET P 


F1 241 


/G/ 


CDBL 


TAB+49 


POP AF 


F2 242 


/G/ 


FIX 


TAB+50 


JP P F NN 


F3 243 


/G/ 


LEN 


TAB+51 


DI 


F4 244 


/G/ 


STR$ 


TAB+52 


CALL P,NN 


F5 245 


/G/ 


VAL 


TAB+53 


PUSH AF 


F6 246 


/G/ 


ASC 


TAB+54 


OR N 


F7 247 


/G/ 


CHR$ 


TAB+55 


RST 3 OH 


F8 248 


/G/ 


LEFT$ 


TAB+56 


RET M 


F9 249 


/G/ 


RIGHTS 


TAB+57 


LD SP,HL 


FA 250 


/G/ 


MID$ 


TAB+58 


JP M F NN 


FB 251 


/G/ 




TAB+59 


EI 
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Upper Character Set 



HEX 


DEC 


POKE 


Vat 


Val 


Display: 


FC 


252 


/G/ 


FD 


253 


/G/ 


FE 


254 


/G/ 


FF 


255 


/G/ 



BASIC 
Keyword: 



PRINT 
Display: 

TAB+60 
TAB+61 
TAB+62 
TAB+63 



Z80 
Opcode: 

CALL M,NN 
<Note 4> 
CP N 
RST 38H 



Note 1 



CB includes RLC, RRC, RL F RR, SLA, SRL, BIT, 
RES, SET. 

Note 2: DD includes IX register manipulations. 

Note 3: ED includes miscellaneous IN, OUT, LD, and ADC 

functions as well as block move and 
compare commands, and interrupt 
mode setting and handling. 

Note 4: FD includes IY register manipulations. 



raphics Note: In the table above /G/ means a graphics 
haracter will be displayed. The table below shows the 
raphics characters and their ASCII code in decimal. 



Gr 
ch 
grap 



128 
132 . 
136 . 

140 • 

144 

■ 

148 | 
152 j 

156 r 

160 

■ 

164 u a 
168 | 

172 , 
176 
180 fc 
184 j 

188 - 



129 ■ 
133 I 
137 S 

141 L 

145 ■ 

■ 

149 | 
153 ■» 

157 y 

161 ■ 

■ 

165 t^ 
169 "| 
173 l| 

177 ■_ 
181 l 
185 ■. 

189 ^ 



130 
134 «■ 

138 I 

142 J 

146 ■ 

■ 

150 |" 
154 J| 
158 fl 

162 ■ 

■ 

166 •• 

170 | 

174 ^ 

178 ^ 

182 |" 

186 J 

190 J 



131 
135 P 
139 * 
143 ■ 

147 - 

■ 

151 P 
155 J 

159 p 

■ 
167 |^ 

171 -I 

175 ^ 

179 - 

183 J 

187 J 

191 | 
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00100 










00110 
00120 
00130 
00140 
00150 










• » 


* * * 


KEEPIT 3.2 •♦•»• 




»» 


SYSTEM /1 2345 TO ENTER «« 












00160 


»» 


USE *READ FOR MENU «« 




00170 


















001 80 










00190 


COPYRIGHT IC) 1980, 19B1 BY DENNIS BATHORY KITSZ 




00200 


ALL RIGHTS RESERVED. NO PART OF THIS PROGRAM MAY 




00210 


BE REPRODUCED BY ANY MEANS, ELECTRONIC, ELECTRO- 




00220 


MECHANICAL, 


OR IN PRINT, WHETHER BY METHODS IN 




00230 


USE OF 


CONCEIVED IN THE FUTUHE, WITHOUT SPECIFIC 




00240 


WRITTEN PERMISSION OF THE AUTHOR. 




00250 








4099 


002B0 


:nkeys 


EQU 


4099H ;INKEY$ BYTE STORAGE AREA 


03FB 


00270 


<YSCAN 


bQU 


03FBH ; KEYBOARD SCAN ROUTINE 


403 D 


00260 


3 ORTFF 


EQU 


403DH ; CASSETTE OUTPUT PORT 


401 A 


00290 


<PLACE 


EQU 


401 AH ;1-BYTE KEYSTROKE STORE 


4019 


00300 


3HIFTR 


tQil 


4019H ;STORAGE FOR LC DRIVER 


4004 


00310 


RESTRT 


EQO 


40D4H ;BASIC INTERP PATCH POINT 


40 A0 


00320 


STGENO 


EQU 


40A0H ;END OF STRINGS POINTER 


40 EB 


00330 


5TACKR 


EOU 


40E8H ; BASIC STACK POINTER 


40FD 


00340 


VAREND 


EQU 


40FDH ;END OF VARIABLE POINTER 


06 CC 


00350 


READY 


EQO 


06CCH ; RETURN TO READY INTACT 


4081 


00360 


MEMTOP 


EQU 


40B1H ;TOP OF BASIC MEMORY 


4000 


00370 


SETPTS 


EQU 


4000H ;SETPOINT RESTART ADDRESS 


02S4 


00380 


WRTBYT 


EQU 


0264H ;ROM 6YTE WRITE ROUTINE 


1D7B 


00390 


BYTE 


EQU 


1D78H ;ROM READ KEYS & TOKEN IZE 


3C00 


00400 
00410 


VIDEO 


EQU 


3C00H ;FIRST SCREEN LOCATION 


3039 


00420 




ORG 


303SH 




00430 


; PREPARE RAM 


AREAS FOR USE 


3039 2AB140 


00440 


START 


LO 


HL,(40B1H) 


303C ED5BA040 00450 




LD 


DE,140A0H) 


3040 0607 


00460 




LD 


B,7 


3042 2B 


00470 




DEC 


HL 


3043 1B 


00480 




OEC 


K 


3044 10FC 


00490 




DJNZ 


»-2 


3046 22B140 


00500 




LO 


(40B1H),HL 


3049 E053A040 00510 




LD 


[40AOHJ ,0E 


304D 23 


00520 




INC 


HL 


304E E5 


00530 




PUSH 


HL 


304F FDE1 


00540 




POP 


IY 




00550 


J READY 


INTERPRETER VECTOR PATCH 




00560 


; GET CURRENT 


CONTENTS OF 4004H 


3051 3EC3 


00570 




LD 


A.0C3H 


3053 FD7700 


00 560 




LD 


(IY+0),A 


3056 ED5B0440 0D590 




LD 


DE, (RESTRT) 


305A FD7301 


00600 




LD 


(IY+1J,E 


3050 FD7202 


00610 




LD 


(IY+2),D 


3060 FD7703 


00620 




LD 


(IY+3),A 


3063 117631 


00630 




LD 


DE.SKPSTP 


3066 F07304 


00640 




LD 


(IY+4J.E 


3069 FD7205 


00650 




LD 


[IY+5),D 


306C 23 


00660 


GRINS 


INC 


HL 


3060 23 


00670 




INC 


HL 


306E 23 


00680 




INC 


HL 


3D6F 220440 


00690 




LD 


( RESTRT ),HL 


3072 AF 


00700 




XOR 


A 


3073 321940 


00710 




LD 


(SHIFTHl.A 




00720 


; CALL 


CLEAR 


AND RETURN TO BASIC 


3076 CDC901 


00730 


RSLVII 


CALL 


01C9H 


3079 C0611B 


007 40 




CALL 


1B61H 


307C 211101 


00750 




LO 


HL,0111H 


307F CDA72B 


00760 




CALL 


28A7H 


30B2 C3CC06 


00770 




JP 


READY 




00780 


; START 


KEYBOARD SCAN 


30B5 213640 


00790 


KBPFIX 


LD 


HL.4036H 


308B 010138 


OOBOO 




LO 


BC.3B01H 


308B 1600 


00810 




LD 


D,0 




00820 


; CHECK EACH 


ROW OF KEY5 


3080 OA 


00830 


KEYPRS 


LD 


A,(BC) 


30BE 5F 


00840 




LD 


E,A 


30BF A3 


00650 




AND 


E 


3090 201 B 


00860 




JH 


NZ, STROKE 


3092 77 


00870 




LD 


(HLJ.A 




00880 


; INC AND 


30S3 14 


00890 


RECHEK 


INC 


D 


3094 2C 


00900 




INC 


L 


3095 CB01 


00910 




RLC 


C 


3097 79 


00920 




LD 


A.C 




00930 


; CHECK II ' (NOT INCL. St 


3098 0680 


00940 




SUB 


BOH 


309A 20F1 


00950 




JR 


NZ, KEYPRS 




00960 


; CHECK IF KEYE 


309C 0607 


00970 




LD 


B,7 


309E 20 


00980 


CLRMEM 


DEC 


L 


309F 86 


00990 




ADD 


A,[HL) 


30A0 1DFC 


01000 




DJNZ 


CLRMEM 


30A2 A7 


01010 




AND 


A 



30A3 3ED0 


01020 


LD 


A,0 




30A5 CO 


01030 


RET 


NZ 






01040 ; RESET 


AUTOREPEAT DELAY TO 




3QA6 321A40 


01050 


LD 


(KPLACEl.A 




30AS C9 


01060 


RET 








01070 ; IF KEYSTROKE 


FOUND CHECK AUTOREPEAT 


LOOP 


30AA A6 


01 080 STROKE 


AND 


(HL) 




30AB 2B1E 


01090 


JR 


Z, FOUND 




30AD 3A9940 


D1100 


LD 


A.IINKEYS) 




30B0 A7 


01110 


AJJD 


A 




30B1 20E0 


01120 


JK 


NZ, RECHEK 




30B3 3A1A40 


01130 


LD 


A.IKPLACE) 




3DB6 3C 


01140 


INC 


A 




3087 321A40 


01150 


LD 


[KPLACEl.A 




30BA FEFF 


01160 


CP 


OFFH 




30BC 2808 


01170 


JR 


Z.DECA 




30BE C5 


01180 


PUSH 


BC 




30BF 06FF 


01190 


LD 


B.OFFH 




30C1 10FE 


01200 TMWSTE 


DJNZ 


TMWSTE 




30C3 C1 


01210 


POP 


BC 




30C4 18CD 


D1220 


JR 


RECHEK 




30C6 3D 


01230 DECA 


DEC 


A 




30C7 321 A40 


01240 


LD 


[KPLACEl.A 






01250 ; GET AND SAVE 


FOUND KEYBOARD BYTE 




30CA 7B 


01260 


LD 


A.E 




30CB 73 


01270 FOUND 


LD 


(HL).E 




30CC 7A 


012B0 


LD 


A.D 




30CD 07 


01290 


RLCA 






30CE 07 


01300 


RLCA 






30CF 07 


01310 


RLCA 






3000 57 


01320 


LD 


D,A 




30D1 0E01 


01330 


LD 


C,1 




3003 79 


01340 BACKUP 


LO 


A,C 




30D4 A3 


01350 


AND 


E 




3DD5 2005 


01360 


JR 


NZ, AROUND 




3007 14 


01370 


INC 


D 




30D8 CB01 


01380 


RLC 


C 




30DA 18F7 


01390 


JR 


BACKUP 




30DC 3A8038 


01400 AROUND 


LD 


A,(3B80H) 




30DF 47 


01410 


LD 


B.A 




30E0 7A 


01420 


LD 


A,D 




30E1 CE40 


01430 


ADO 


A.40H 




30E3 FE60 


01440 


CP 


60H 




30E5 3016 


01450 


JR 


NC.Z0429H 




30E7 57 


01460 


LD 


D.A 




30EB 3A403B 


01470 


LD 


A.13B40H) 




30EB E610 


01480 


AND 


10H 




30ED 2009 


01490 


JH 


NZ, CNTROL 




30EF 7A 


01500 


LO 


A.D 




3OF0 CBD8 


01510 


RRC 


B 




3DF2 383D 


01520 


JH 


C, GOAWAY 




30F4 C620 


01530 


ADD 


A.20H 




30FE 1839 


01540 


JR 


GOAWAY 




30F8 7A 


01550 CNTROL 


LD 


A.D 




30F9 D640 


01560 


SUB 


40H 




30FB 1834 


01570 


JR 


GOAWAY 




30FD 067D 


01580 Z0429H 


SUB 


70H 




30FF 3010 


01590 


JR 


NC.Z043DH 




3101 C640 


01600 


ADD 


A.40H 




3103 FE3C 


01610 


CP 


3CH 




3105 3802 


01620 


JR 


C.Z0435H 




3107 EE10 


01630 


XOR 


10H 




3109 CB08 


01640 Z0435H 


RRC 


B 




31 OB 3024 


01650 


JR 


NC, GOAWAY 




31 OD EE10 


01660 


XOR 


10H 




31 OF 1820 


01670 


JR 


GOAWAY 




3111 07 


01680 Z043DH 


RLCA 






3112 CB08 


01690 


RRC 


B 




3114 3001 


01700 


JH 


NC.Z0443H 




3116 3C 


01710 


INC 


A 




3117 212131 


01720 Z0443H 


LD 


HL, TABLET 




311A 4F 


01730 


LD 


C,A 




311B 0600 


01740 


LD 


8,0 




311D 09 


01750 


ADD 


HL,BC 




311E 7E 


01760 


LD 


A,[HLJ 




311F 1810 


01770 


JR 


GOAWAY 




3121 ODOO 


01780 TABLET 


DEFW 


ODODH 




3123 1F1F 


01790 


OEFW 


1F1FH 




3125 0101 


01800 


DEFW 


0101H 




3127 5B1B 


01810 


DEFW 


1B5BH 




3129 OAOO 


01B20 


DEFW 


OOOAH 




31 2B 0818 


01830 


DEFW 


1B08H 




3120 0919 


01840 


DEFW 


1909H 




31 2F 2020 


01850 


OEFW 


2020H 




3131 57 


01860 GOAWAY 


LD 


D.A 




3132 3A1038 


01870 BEEEEP 


LD 


A,[3B1DH) 




3135 FE01 


01880 


CP 


1 




3137 2016 


01890 


JR 


NZ.BLEEEP 




3139 3A8038 


01900 


LD 


A,(38B0H) 




313C FE01 


01910 


CP 


1 




313E 200F 


01920 


JR 


NZ,BLEEEP 




3140 3A1940 


01930 


LD 


A.ISHIFTR) 




3143 EE01 


01940 


XOR 


1 
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3145 321940 
3148 010005 
314B CD6000 
314E C9 

314F 018001 
31 58 CD6000 
3155 7A 



3156 
3157 
3158 
315A 
315D 
315F 
3160 
3162 
3163 
3164 
3166 
3167 
3169 
316A 
316C 
316E 
316F 
3171 
3172 
3173 



Cb 

F5 

0640 

3 A3 040 

E6FD 

67 

F602 

6F 

70 

D3FF 

7C 

D3FF 

C5 

0640 

10FE 

C1 

10F2 

F1 

C1 

C35204 



3176 

3176 E3 

3177 7D 

3178 FE5B 
317A 2003 
317C 7C 
317D FE1D 
317F E3 
3180 C27B1D 

3183 CD7B1D 
3186 FECF" 
3188 2803 
31 8A 2B 
31 SB FDE9 
31 8D CD781D 
3190 CABES1 



3193 
3195 
3197 
3199 
319B 
3190 
31A0 
31A2 
31A5 
31A7 
31AA 
31AC 
31AE 
31 BO 
31 B2 
31 B4 
31 B6 
31BB 
31BA 
31 BC 
31BE 

31C1 
31C4 
31C7 
31CA 
31CD 
31 DO 
3103 
31D6 
31 D9 



FEAD 

287F 

FEBB 

2866 

FEA2 

CAE432 

FECC 

CAB034 

FEC8 

CACE34 

FEF2 

284A 

FEB2 

2829 

FEAO 

283A 

FEAA 

282E 

FE8B 

2B03 

C39719 

213B35 
CDA728 
21A335 
CDA728 
214236 
CDA728 
210836 
CDA72B 
1823 



310B 3E01 
31 DD 321940 
31E0 211035 
31 E3 221 E40 
31E6 1816 

31 E8 215804 
31 EB 221 E40 
31EE 180E 

31F0 21E303 
31F3 221640 
31F6 180B 



01950 

01960 

01970 

01880 

01990 

02000 

02010 

02020 

02030 

02040 

02050 

02060 

02070 

02080 

02090 

02100 

02110 

02120 

02130 

02140 

02150 

02160 

02170 

02180 

02190 

02200 

02210 

02220 

02230 

02240 

02250 

02260 

02270 

02280 

02290 

02300 

02310 

02320 

02330 

02340 

02350 

02360 

02370 

02380 

02390 

02400 

02410 

02420 

02430 

02440 

02450 

02460 

0247D 

02480 

02490 

02500 

02510 

02520 

02530 

02540 

02550 

02560 

02E70 

02580 

02590 

02600 

02610 

02620 

02E30 

02640 

02650 

02660 

02670 

026 BO 
02690 
02700 
02710 
02720 
02730 
02740 
02750 
02760 
02770 

027 BO 
02790 
02800 
02810 
02820 
02830 
02840 
02B50 
02860 
02870 



LD 
LD 

CALL 
RET 
; DEBOUNCE 
BLEEEP LD 

CALL 
LD 



(SHIFTRJ.A 

BC,500H 

0060H 



BC.1B0H 

0060H 

A.D 



BEEP ROUTINE ON FOUND KEYSTROKE 



PUSH 
PUSH 
LD 

LD 

AND 

LD 

OR 

LD 

LD 

OUT 

LD 

OUT 

PUSH 

LD 

DJNZ 

POP 

DJNZ 

POP 

POP 

JP 



BC 
AF 

B.40H 

A.IPORTFF) 

OF OH 

H,A 

2 

L,A 

A,L 

(OFFH).A 

A,H 

(OFFH) ,A 

BC 

B,40H 

FREQCY 

BC 

BEEPER 

AF 

BC 

0452H 



CHECK FOR STATUS OF BASIC STACK 



SKPSTP 
BEGIN 



EDO 

EX 

LD 

CP 

JR 

LD 

CP 

EX 

JP 



(SPJ.HL 

A,L 

5BH 

NZ.NOTRDY 

A,H 

1DH 

(SP).HL 

NZ.BYTE 



CHECK TO SEE IF SPECIAL STAR (•) COMMAND 



CALL 

CP 

JR 

DEC 
JP 

CALL 
JP 



BYTE 

OCFH 

Z.OKSTAR 

HL 

(IY) 

BYTE 

Z.SYNERR 



; CHECK STATUS OF SAVE COMMAND 



SAVE 



SYNERfl 



CP 
JR 
CP 
JR 
CP 
JP 
CP 

JP 

CP 

JP 

CP 
JR 
CP 
JR 
CP 
JR 
CP 
JR 
CP 
JR 
JP 



OADH 

Z, SAVER 

OBBH 

Z, RENEW 

0A2H 

Z, OPENER 

OCCH 

Z,STPSET 

0C8H 

Z.MEMSET 

0F2H 

Z.INBEEP 

0B2H 

Z , LOWCAS 

OAOH 

Z.BIPOFF 

OAAH 

Z.UPPPER 

OBBH 

Z,HENU 

1997H 



THIS IS THE MENU 



MENU 



LD 

CALL 

LD 

CALL 

LD 

CALL 

LD 

CALL 

JR 



HL.INTR01 
28A7H 
HL.INTR02 
28A7H 
HL.INTR03 
28A7H 
HL,INTR04 
2BA7H 
READYX 

; THIS PUTS LOWER CASE IN PLACE 
LOWCAS LD A,1 

LD (SHIFTRJ.A 

LD HL, LOWER 

LD (401EH),HL 

JR READYX 

; THIS REMOVES LOWER CASE DISPLAY 
UPPPER LD HL.0458H 

LD (401EH),HL 

JR READYX 

; THIS REMOVES KBPFIX ROUTINE 
BIPOFF LD HL.03E3H 

LD (4016H],HL 

JR READYX 





02880 


; THIS 


PUTS KBPFIX IN PLACE 


31F8 218530 


02890 


INBEEP 


LD 


HL, KBPFIX 


31FB 221640 


02900 




LD 


(4016H),HL 


31FE C3CC06 


02910 


READYX 


JP 


READY 




02920 


; THIS 


IS BEGINNING OF RENEW SEQUENCE 


3201 ED5BA440 02930 


RENEW 


LD 


DE,(40A4HJ 


3205 3EFF 


02940 




LD 


A.OFFH 


3207 12 


02950 




LD 


IDE), A 


3208 CDFC1A 


02960 




CALL 


1AFCH 


320B 23 


02970 




INC 


HL 


320C 22F940 


02980 




LD 


(40F9HJ ,HL 


320F E07BE840 02990 




LD 


SP,(40E8H] 


3213 C37630 


03000 


FGHIJ 


JP 


RSLVII 




03010 


; THIS 


CHECK! 


I NEXT BYTE FOR HUN COMMAND 


3216 CD781D 


03020 


SAVER 


CALL 


BYTE 


3219 FEDO 


03030 




CP 


ODOH 


321B 20A1 


03040 




JR 


NZ.SYNERR 


321D CD781D 


03050 




CALL 


BYTE 


3220 FE8E 


03060 




CP 


BEH 


3222 C2F433 


03070 




JP 


NZ.MACH 




03080 


; CHECK F 


3225 CD781D 


03090 




CALL 


BYTE 


3228 FE22 


0310D 




CP 


022H 


322A 2092 


03110 




JR 


NZ.SYNERR 




03120 


; CHECK TO SEE THAT NAME IS IN PLACE 


322C C0781D 


03130 




CALL 


BYTE 


322F CAA024 


03140 




JP 


Z.24A0H 




03150 


; SAVE 


BASIC 


POINTERS IN STACK 


3232 E5 


03160 




PUSH 


HL 


3233 F5 


03170 




PUSH 


AF 


3234 D5 


031 BO 




PUSH 


DE 


3235 C5 


03190 




PUSH 


BC 




03200 


; DEFINE TAPE 


DRIVE 0, TURN ON RECORDER 




03210 


; THEN 


WRITE 


LEADER AND SYNC BYTE 




03220 


; AND 


WRITE MACHINE PROGRAM CODE 55H 


3236 AF 


03230 




XOR 


A 


3237 CD1202 


03240 




CALL 


021 2H 


323A C08702 


03250 




CALL 


02B7H 


323D 3E55 


03260 




LD 


A.55H 


323F CD6402 


03270 




CALL 


WRTBYT 




03280 


; WRITE P 


3242 06 06 


03290 




LD 


B.06 


3244 2B 


03300 




DEC 


HL 


3245 CD781D 


03310 


NAMES 


CALL 


BYTE 


3246 FE22 


03320 




CP 


22H 


324A 2807 


03330 




JR 


Z, NEXTBT 


324C CD6402 


03340 




CALL 


WRTBYT 


324F 10F4 


03350 




DJNZ 


NAMES 


3251 1807 


03360 




JR 


DUMP 




03370 


i FILL 


OUT WITH 20H (ASCII BLANKS) IF NECESSARY 


3253 3E20 


03380 


NEXTBT 


LD 


A.20H 


3255 CD6402 


03390 




CALL 


WRTBYT 


3258 10F9 


03400 




OJNZ 


NEXTBT 




03410 


; DUMP 


FIRST 


TWO PAGES (4000 TO 41 FF] TO TAPE 


325A 210040 


03420 


DUMP 


LD 


HL.SETPTS 


3250 CDC032 


03430 




CALL 


OUTSEQ 


3260 C0C032 


03440 




CALL 


OUTSEQ 




03450 


; DUMP 


REST OF POINTERS (4200 TO 42E9) TO TAPE 


3263 06E9 


03460 




LD 


B.0E9H 


3265 C0C032 


03470 




CALL 


OUTSEQ 




03480 


; FIND 


END OF 


PROGRAM VARIABLES AND ARRAYS 


3268 E05BF04C 


03490 




LD 


DE,(VARENDJ 




03500 


; DUMP 


FIRST 


SEGMENT OF PROGRAM TO TAPE 


326C 7B 


03510 




LD 


A,E 


326D 95 


03520 




SOB 


L 


326E 47 


03530 




LD 


B,A 


326F CDC032 


03540 




CALL 


OUTSEQ 




03550 


; DUMP 


PROGRAM TO TAPE PAGE BY PAGE 


3272 7C 


03560 


NXTPGE 


LD 


A,H 


3273 3D 


03570 




DEC 


A 


3274 BA 


03580 




CP 


D 


3275 2805 


03590 




JR 


Z.FINSH1 


3277 CDC032 


03600 




CALL 


OUTSEQ 


327A 1BF6 


03610 




JR 


NXTPGE 




D3620 


; FIND 


BEGINNING OF STRING STORAGE AREA 


327C 2AEB40 


03630 I 


=INSH1 


LD 


HL.(STACKR) 




03640 


; FIND 


TOP OF AVAILABLE MEMORY 


327F ED5BB140 


03650 




LD 


DE.(MEMTDP) 




03660 


; DUMP 


FIRST SEGMENT OF STRING-TO-MEMORY END 


3283 13 


03670 




INC 


DE 


3284 7B 


03680 




LD 


A.E 


3285 95 


03690 




SOB 


L 


3286 47 


03700 




LD 


B,A 


3287 CDCD32 


03710 




CALL 


OUTSEQ 




03720 | 


; DUMP REMAINDER OF MEMORY PAGE BY PAGE 


328A 7C 


03730 NXTBCH 


LD 


A,H 


328B 3D 


03740 




DEC 


A 


328C BA 


03750 




CP 


D 


32B0 2805 


03760 




JR 


Z, KEEPIT 


32BF CDC032 


03770 




CALL 


OUTSEQ 


3292 1BF6 


03780 




JR 


NXTBCH 




03790 ; 


DUMP 


KEEPIT 


CONTROL BYTES 


3294 2AB140 


03800 KEEPIT 


LD 


HL,(40B1H] 


3297 0610 


03810 




LD 


B.10H 
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3289 CDC032 

329C 21003C 
329F 0604 
32A1 C5 
32A2 CD6E32 
32A5 CI 
32A6 10F9 

32AB 3E7B 

32AA CD6402 

32AD 3ECC 
32AF C06402 
32B2 3E06 
32B4 CD6402 

32B7 C1 
32B8 01 
32B9 F1 
32BA E1 

32BB C3CC06 



32BE 0600 
32C0 3E3C 
32C2 CD6402 

32CS 7B 

32C6 CD6402 

32C9 70 
32CA 4F 
32CB CD6402 

32CE 79 
32CF 84 

3200 4F 

3201 7C 

3202 CD6402 

3205 79 

3206 86 

3207 4F 

3208 7E 

3209 CD6402 
320C 23 
320D 10F6 

32DF 79 
32E0 CD6402 
32E3 C9 

32E4 C07810 
32E7 FE22 
32E8 C2BE31 
32EC E5 
32ED CDD133 
32F0 CUC901 
32F3 1840 



32F5 
32F6 
32F9 
32FB 
32FE 
32FF 
3301 
3304 
3305 
3306 
3307 
3309 
330C 
3300 
33 OF 
3312 
3313 
3316 



03B20 CALL OUTSEQ 

03B30 ; DUMP COMPLETE VIDEO MEMORY 

03840 LD HL, VIDEO 

03850 LD B,4 

D3860 COEF PUSH BC 

03870 CALL PBEOUT 

03880 POP BC 

03890 DJNZ CDEF 

03900 ; WRITE END OF PROGRAM CODE (76) 

03910 LD A.78H 

03820 CALL WRTBYT 

03930 ; WHITE START ADDRESS AFTER LOAD (06CCH) 

03940 LD A.OCCH 

03950 CALL WRTBYT 

03960 LD A, 06 

03970 CALL WRTBYT 

03BB0 ; RESTORE BASIC INFORMATION TO REGISTERS 

03990 POP BC 

04000 POP DE 

04010 POP AF 

04020 POP HL 

04030 ; RETURN TO BASIC PROGRAM IN PROGRESS 

04D4C JP READY 

04050 ; OUTPUT SEQUENCE SUBROUTINE 

04060 ; WRITE BLOCK HEADER CODE [3d 

04070 PREOUT LD B,0 

04080 OUTSEQ LD A.3CH 



7A 

21403C 

E6F0 

CDB833 

7A 

E60F 

CDB033 

77 

23 

7B 

E6F0 

C0B833 

7B 

E60F 

CDB033 

77 

21803C 

0610 



3318 1A 

3319 E6F0 
331 B CDBB33 
331E 1A - 
331 F E60F 
3321 CD6033 

3324 77 

3325 23 

3326 23 

3327 13 

3328 10EE 



04090 
04100 
04110 
04120 
04130 
04140 
04150 
04160 
04170 
041 BO 
04190 
04200 
04210 
04220 
04230 



CALL WRTBYT 

GET NUMBER OF BYTES TO WRITE 

LD A,B 

CALL WRTBYT 
GET START ADDRESS LSB, SAVE IN C [CHECKSUM) 

LD A,L 

LD C,A 

CALL WRTBYT 

GET START ADDRESS MSB, SAVE IN C (CHECKSUM) 



LD 

ADD 

LD 

LD 

CALL 



A,C 
A,H 
C,A 
A,H 
WRTBYT 



GET BLOCK OF DATA, WRITE, AND SAVE IN C 



04240 WRTPGE LD A,C 

04250 ADO A,(HL) 

0426D LD C,A 

04270 LD A.IHLJ 

042B0 CALL WRTBYT 

04290 INC HL 

04300 DJNZ WRTPGE 

04310 ; GET CHECKSUM FROM C AND WRITE TO TAPE 

04320 LD A,C 

04330 CALL WRTBYT 

04340 RET 

04350 ; GET REST OF DATA AND CONVERT 



04360 OPENER 

04370 

043 BO 

04390 

04400 

04410 

04420 

04430 



CALL 

CP 

JP 

PUSH 

CALL 

CALL 

JR 



BYTE 
22H 

NZ.SYNERR 
HL 

XX99 

01C9H 

NEXT99 



GET 16 SCREEN POSITIONS READY (10H) 



04440 CONTNT 

04450 

04460 

04470 

04480 

04490 

04500 

04510 

04520 

04530 

04540 

04550 

04560 

04570 

04580 

04590 

04600 

04610 

04620 



LD 

LD 

AND 

CALL 

LD 

AND 

CALL 

LD 

INC 

LD 

AND 

CALL 

LD 

AND 

CALL 

LD 

LD 

LD 



A,0 

HL.3C40H 

OF OH 

RRRRS 

A,D 

OFH 

HEXASC 

[HLl.A 

HL 

A,E 

OFOH 

RRRRS 

A,E 

OFH 

HEXASC 

iHL) ,A 

HL.3C80H 

B.10H 



DISPLAY CONTENTS OF ADDRESS CHOSEN 



04630 C0NT02 LD A,(DE) 

04640 AND OFOH 

04650 CALL RRRRS 

04660 LD A, IDE) 

04670 AND OFH 

046B0 CALL HEXASC 

04690 LD (HL) ,A 

04700 INC HL 

04710 INC HL 

04720 INC DE 

04730 ; REDO IT 16 TIMES FOR FULL LINE 

04740 DJNZ CONT02 



332A 0610 


04750 ; 
04760 


DISPL 


AY ASCII 
LD 


VALUES TOO 
B.10H 


33 2C C5 


04770 




PUSH 


BC 


332D 1B 


04780 




DEC 


DE 


332E 10FD 


04790 




DJNZ 


$-1 


3330 C1 


04800 




POP 


BC 


3331 C5 


04810 




PUSH 


BC 


3332 21C03C 


04820 




LD 


HL.3CC0H 


3335 1A 


04630 BBBA 


LD 


A,(DE) 


3336 77 


04840 




LD 


IHL), A 


3337 23 


04850 




INC 


HL 


3338 23 


04860 




INC 


HL 


3339 23 


04870 




INC 


HL 


333A 13 


048 BO 




INC 


DE 


333B 10FB 


04890 




DJNZ 


BBBA 


3330 C1 


04900 




POP 


BC 


333E 1B 


04910 




DEC 


DE 


333F 10FD 


04820 




DJNZ 


$-1 


3341 C9 


04930 




RET 






04940 ; 


; SCAN 


FOR EDIT 


/ GET THIRD SCREEN LINE 


3342 CDF532 


04950 NEXT99 


CALL 


CONTNT 




04960 ; 


; SCAN 


KEYBOARD 


FOR BREAK, ARROWS 


3345 3A4038 


04970 1 


EDITOR 


LD 


A, (3840H) 


3348 17 


04980 




RLA 




3349 17 


04990 




RLA 




334A 3003 


05000 




JR 


NC.AAAA 


334C 13 


05010 




INC 


DE 


3340 1850 


05020 




JR 


STNDRD 


334F 17 


DS03D , 


MM 


RLA 




3350 3003 


05040 




JR 


NC.AAAB 


3352 18 


05050 




DtC 


DE 


3353 184A 


05060 




JR 


STNDRD 


3355 0610 


05070 i 


^AAB 


LD 


B.10H 


3357 17 


05080 




RLA 




3358 3005 


05090 




JR 


NC.AAAC 


335A IB 


05100 




DEC 


DE 


3356 10F0 


051 1D 




DJNZ 


t-1 


335D 1840 


05120 




JR 


STNDRD 


335F 17 


05130 


MAC 


RLA 




3360 3005 


05140 




JR 


NC, BREEK 


3362 13 


05150 




INC 


DE 


3363 10FD 


05160 




DJNZ 


t-1 


3365 1838 


05170 




JR 


STNDRD 


3367 17 


05180 


BREEK 


RLA 




3368 3004 


05190 




JR 


NC.AAAD 


336A E1 


05200 




POP 


HL 


336B C3CC06 


05210 




JP 


READY 




05220 


; DISPLAY EDITING / GET FIFTH SCREEN LI 


336E 210130 


05230 


MAD 


LD 


HL.3D01H 


3371 365F 


05240 




LD 


[HL],5FH 


3373 28 


05250 




DEC 


HL 


3374 365F 


05260 




LD 


[HL),5FH 


3376 0602 


05270 




LD 


B,2 


3378 05 


05280 


AAAE 


PUSH 


DE 


3379 E5 


05290 




PUSH 


HL 


337A CD4900 


05300 




CALL 


0049H 


3370 E1 


05310 




POP 


HL 


337E D1 


05320 




POP 


UE 


337F FE47 


05330 




CP 


47H 


3381 30C2 


05340 




JR 


NC, EDITOR 


3383 FE30 


05350 




CP 


30H 


3385 38BE 


05360 




J.R 


C, EDI TOR 


3387 FE3A 


05370 




CP 


3AH 


3389 3804 


05380 




JR 


C.AAAF 


33BB FE40 


05390 




CP 


40H 


33BD 38B6 


05400 




JR 


C, EDITOR 


338F 77 


05410 


AAAF 


LD 


(HL),A 


3390 23 


05420 




INC 


HL 


3391 10E5 


05430 




DJNZ 


AAAE 




05440 


; CONVERT CHOSEN DATA TO HEX 


3393 2B 


05450 




DEC 


HL 


3394 C0A733 


05460 




CALL 


ASCHEX 


3397 4F 


05470 




LD 


C,A 


3398 2B 


05480 




DEC 


HL 


3399 C0C233 


05490 




CALL 


LLLLS 


33 9C 81 


05500 




ADD 


A,C 




05510 


; PUT 


NEW BYTE 


IN PLACE 


339D 12 


05520 




LD 


(DE).A 


339E 13 


05530 




INC 


DE 




05540 


; DISPLAY REVISED LINE OF DATA 


339F CDF532 


05550 


STNDRO 


CALL 


CONTNT 


33A2 CDCA33 


05560 




CALL 


DELAY 


33A5 189E 


05570 




JR 


EDITOR 




05580 


; ASCII TO HEXADECIMAL CONVERSION 


33A7 7E 


05590 


ASCHE* 


; LD 


A,(HL) 


33A9 D630 


05600 




SUB 


3 OH 


33 AA FEOA 


05610 




CP 


OAH 


33AC 08 


05620 




RET 


C 


33AD D607 


05630 




SUB 


7 


33AF C9 


05640 




RET 






05650 


; HEXADECIMAL 


TO ASCII CONVERSION 


33B0 C630 


05660 


HEXASC 


: ADD 


A,30H 


33 B2 FE3A 


05670 




CP 


3AH 
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33B4 06 


05680 




HET 


C 


33B5 C607 


05690 




ADD 


A, 7 


33 B7 C9 


057DO 




RET 






05710 


; RIGHT 


ROTATES 


FOR CONVERSIONS 


33B8 OF 


05720 


RflflRS 


RRCA 




33 BS OF 


05730 




RRCA 




33 BA OF 


05740 




RRCA 




33 BB OF 


05750 




RRCA 




33BC COB033 


05760 




CALL 


HEXASC 


33BF 77 


05770 




LD 


(HL),A 


33C0 23 


05780 




INC 


HL 


33C1 CS 


05790 




RET 






05600 


i LEFT 


ROTATES 


FOR CONVERSION 


33C2 COA733 


05B10 


LLLUS 


CALL 


ASCHEX 


33C5 07 


05820 




RLCA 




33C6 07 


05830 




RLCA 




33C7 07 


05640 




RLCA 




33C8 07 


05B50 




RLCA 




33C9 09 


05860 




RET 






05870 


; DELAY 


FOR SCREEN DISPLAYS 


33CA 010020 


05680 


DELAY 


LD 


BC.2000H 


33CD CD6000 


05830 




CALL 


0060H 


33D0 CS 


05800 




RET 






05910 


; GET/CONVERT ASCII FROM BUFFER 




05920 


; TO HEXADECIHAL ADDRESS 


33D1 0604 


05830 


XX99 


LD 


B,4 


3303 C07810 


05840 


SSSS 


CALL 


BYTE 


3306 F5 


05850 




PUSH 


AF 


33D7 10FA 


05960 




DJNZ 


SSSS 


33D9 F1 


05870 




POP 


AF 


330A 77 


05980 




LD 


(HLJ.A 


330B CDA733 


05990 




CALL 


ASCHEX 


330E 5F 


06000 




LD 


E,A 


33DF F1 


06010 




PUP 


AF 


33ED 77 


06020 




LD 


[HLI.A 


33E1 CDC233 


06030 




CALL 


LLLLS 


33E4 83 


06040 




ADD 


A,E 


33 E5 5F 


06050 




LD 


E,A 


33E6 F1 


D6060 




POP 


AF 


33E7 77 


06070 




LD 


(HL),A 


33E8 C0A733 


06000 




CALL 


ASCHEX 


33EB 57 


06090 




LD 


D,A 


33EC F1 


06100 




POP 


AF 


33ED 77 


06110 




LD 


[HL),A 


33EE CDC233 


06120 




CALL 


LLLLS 


33F1 BE 


06130 




ADD 


A,D 


33F2 57 


06140 




LD 


D,A 


33F3 C9 


06150 




RET 






06160 


; RESULT OF ABOVE IN DE REGISTER 




06170 


; CHECK 


FOR "OPEN" COMMAND 


33F4 FEA2 


06180 


MACH 


CP 


0A2H 


33F6 2005 


06190 




JR 


NZ.SYN2 




06200 


; CHECK 


FOR QUOTATION MARK DELIMITED 


33F8 CD7810 


06210 




CALL 


BYTE 


33FB D622 


06220 




SUB 


22H 


33FD C2BE31 


06230 


SYN2 


JP 


NZ.SYNERR 




06240 


; TURN 


ON TAPE 


DRIVE, WRITE LEADER 




06250 


; AND SYNC BYTE 


, MACHINE CODE HEADER 


3400 CD1202 


06260 




CALL 


021 2H 


3403 CD8702 


06270 




CALL 


0287H 


3406 3E55 


06280 




LD 


A.55H 


3408 CD6402 


06230 




CALL 


WRTBYT 




0630D 


; WRITE 


NAME TO 


TAPE UNTIL 




06310 


; COMMA 


DELIMITER IS FOUND 


3408 0606 


06320 




LD 


B.06 


3400 CD7B1D 


06330 


NAME99 


CALL 


BYTE 


3410 FE2C 


06340 




CP 


2CH 


3412 2807 


06350 




JR 


Z,NXTB99 


3414 CD6402 


06360 




CALL 


WRTBYT 


3417 10F4 


06370 




DJNZ 


NAME99 


3419 1807 


06380 




JR 


DUMP99 




06390 


; FILL 


OUT WITH 


BLANKS IN NAME 




06400 


; LESS 


THAN 6 CHARACTERS 


341 B 3E20 


06410 


NXTB99 


LD 


A.20H 


341 D CD6402 


06420 




CALL 


WRTBYT 


3420 1DF9 


06430 




DJNZ 


NXTB99 




06440 


; CHECK 


FOR COMMA DELIMITER 


3422 CD781D 


06450 


DUMP99 


CALL 


BYTE 


3425 FE2C 


06460 




CP 


2CH 


3427 20D4 


06470 




JR 


NZ.SYN2 




06480 


; GET START ADDRESS AND SAVE 


3429 CDD133 


06490 




CALL 


XX99 


342C D5 


06500 




PUSH 


DE 




06510 


; CHECK 


FOR NEXT COMMA DELIMITER 


342D CD7B1D 


06520 




CALL 


BYTE 


3430 FE2C- 


06530 




CP 


2CH 


3432 2805 


06540 




JR 


Z.TTTT 


3434 01 


06550 




POP 


OE 


3435 AF 


06560 




XOfl 


A 


3436 C3A024 


06570 




JP 


24A0H 




06580 


; GET END ADDRESS AND SAVE 


3439 C0D133 


06590 


TTTT 


CALL 


XX99 


343C D5 


06600 




PUSH 


DE 





06610 


; EXECUTION ADDRESS AFTER FINAL COMMA 


3430 CD7B1D 


06620 


CALL 


BYTE 


3440 FE2C 


06630 


CP 


2CH 


3442 2808 


06640 


JR 


Z, EXECU 




06650 


; AUTOEXECUTE 06CC IF NOT SPECIFIED 


3444 21CC06 


06660 


LD 


HL,06CCH 


3447 227 E40 


06670 


LD 


I407EH1.HL 


344A 1807 


06680 


JR 


SRITSS 




06690 


; GET EXECUTION 


I ADDRESS 


344C CD0133 


D6700 


EXECU CALL 


XX99 


344F EDS37E4C 


I 06710 


LD 


I407EH),DE 




06720 


; 16-BIT SUBTRACTION GETS NUMBER OF 




06730 


; BYTES; GET START ADDR. & COMPL'T. 


3453 E1 


06740 


WRIT99 POP 


HL 


3454 D1 


06750 


POP 


DE 


3455 05 


06760 


PUSH 


DE 


3456 7A 


06770 


LD 


A,D 


3457 2F 


06780 


CPL 




345B 57 


06790 


LD 


D,A 


3459 7B 


06800 


LD 


A,E 


345A 2F 


06810 


CPL 




345B 5F 


06820 


LD 


E,A 




06830 


; END ADDRESS < 


COMPL'T = BYTES 




06840 


; ADD 1 FOR SUE 


I, 1 FOR INCLUSIVE 


345C 18 


06850 


ADD 


HL.DE 


3450 23 


06860 


INC 


HL 


345E 23 


06B70 


INC 


HL 




06880 


; TRANSFER BYTES TO WRITE TO DE 


345F E5 


06 830 


PUSH 


HL 


3460 01 


06900 


POP 


DE 




06810 


; RESTORE START 


ADDRESS TO HL 


3461 El 


06920 


POP 


HL 


3462 43 


06930 


LD 


B.E 




06940 


; ZERO E REGISTER, INC D, TO GET 




06950 


; TOTAL NUMBER 


OF PAGES; SAVE IT 


3463 04 


06360 


INC 


B 


3464 14 


06970 


INC 


D 


3485 D5 


06980 


LPS8 PUSH 


DE 


3488 CDC032 


06990 


CALL 


OUTSEQ 




07000 


; CHECK IF ALL 


PAGES WRITTEN 


3469 01 


07010 


POP 


DE 


348A 15 


07020 


DEC 


D 


346B 20F8 


07030 


JR 


NZ.LP99 




07040 


; WRITE END OF 


PROGRAM CODE 


346D 3E7B 


07050 


LD 


A.78H 


348F CD6402 


07060 


CALL 


WRTBYT 




07070 


; WRITE START ADDRESS; 06CC = DEFAULT 


3472 3A7E40 


07080 


LD 


A,(407EH) 


3475 CD6402 


07090 


CALL 


WRTBYT 


3478 3A7F40 


D7100 


LD 


A,(407FH] 


3478 CD6402 


07110 


CALL 


WRT8YT 


- 


07120 


; RETURN TO COMMAND LEVEL 


347E 1837 


07130 


JR 


PREP2 


- 


07140 


; START SETUP OF STEPPER ROUTINE 




07150 


; FIRST FIND IF 


ARGUMENT EXISTS 


3480 F5 


07160 


STPSET PUSH 


AF 


3481 E5 


07170 


PUSH 


HL 


3482 C07B1D 


07180 


CALL 


BYTE 


3485 B7 


07190 


OR 


A 




07200 


; ARGUMENT EXISTS - JUMP TO ROUTINE 


3486 200C 


07210 


JR 


NZ.IIII 




07220 


; OTHERWISE JUMP PAST SINGLE STEPPER 


3488 FD360476 


07230 


LD 


(IY+4J,SKPSTPa00FFH 


348C FD360531 


07240 


LD 


(IY+5J ,SKPSTP110FFOOH<-8 


3480 E1 


07250 


POP 


HL 


3491 F1 


07260 


POP 


AF 


3482 1823 


07270 


JR 


PREP2 




07280 


; GET VALUE FROM A REGISTER INTO D 


34S4 0630 


07290 


IIII SUB 


30H 


3486 17 


07300 


RLA 




3487 17 


07310 


RLA 




3488 17 


07320 


RLA 




3499 17 


07330 


RLA 




348A 57 


07340 


LD 


D.A 




07350 


; GET NEXT BUFFER VALUE ELSE SN ERROR 


34SB CD7810 


07360 


CALL 


BYTE 


349E B7 


07370 


OR 


A 


34SF 2005 


07380 


JR 


NZ.ABCD 


34A1 E1 


07380 


POP 


HL 


34A2 F1 


07400 


POP 


AF 


34A3 C3BE31 


07410 ! 


3YN3 JP 


SYNERR 




07420 


; GET NEXT VALUE FROM BUFFER INTO E 


34A6 D630 


07430 l 


*BCD SUB 


3 OH 


34AB 82 


07440 


ADD 


A,D 


34AS 57 


07450 


LD 


D.A 




07460 


; PATCH STEPPER 


INTO PLACE 


34AA FD3604BA 


07470 


LD 


IIY+4) .JMPPOS&OOFFH 


34AE FD360534 


07480 


LD 


(IY+5) ,JMPPOS&0FF00H<-8 




07 430 


i GET DELAY VALUE INTO REGISTER 




07500 


; AND GO OUT TO 


READY PROMPT 


3462 FD7206 


07510 


LD 


(IY+6),D 


3465 E1 


07520 


POP 


HL 


3486 F1 


07530 


POP 


AF 



280 



34B7 C3CC06 


0754U PREP2 


JP 


REAOY 


3SA3 2A 




07550 ; 


THIS 


IS THE STEPPER ROUTINE 


35C9 OA 


34BA 


07560 JMPPOS 


EOil 


1 


35CA 2A 


34BA F5 


07570 STEPPR 


PUSH 


AF 


35EF OA 


34BB CS 


07580 




PUSH 


BC 


35F0 2A 




07590 ; 


WAIT 


FOR SHIFT TO BE PRESSED 


3614 OA 


34BC 3ABD36 


07600 LUPER 


LD 


A,(38B0H) 


3615 2A 


34BF A7 


07610 




AND 


A 


3640 OD 


34C0 28FA 


07620 




JR 


Z, LUPER 


3641 00 




07630 ; 


LOAD 


DELAY VALUE INTO BC 


3642 2A 


34C2 4F 


07640 




LD 


C,A 


366B OA 


34C3 FD4E06 


07650 




LD 


B,(IY+6) 


366C 2A 




07660 ; 


CALL 


DELAY U 


1 ROM 


3693 OA 


34C6 C06000 


07670 




CALL 


0060H 


3694 2A 


34C9 C1 


07680 




POP 


BC 


36BB OA 


24CA F1 


07690 




POP 


AF 


36BC 2A 




07700 ; 


BACK 


TO REST 


OF TEST SEQUENCE 


36D6 00 


34CB C37631 


07710 




JP 


BEGIN 


36D7 00 




07720 ; 


BEGIN 


MEMORY 


RESET SEQUENCE 


36DB 4E 




07730 ; 


CHECK 


FOR QUOTE MARK DELIMITER 


370A OA 


34CE CD781D 


07740 MEMSET 


CALL 


BYTE 


3708 4E 


3401 FE22 


07750 




CP 


22H 


373B OA 


3403 20CE 


07760 




JR 


NZ.SYN3 


3738 4E 




07770 i 


CONVERT 


OPERAND TO HEX 


3773 DO 


3405 CDD133 


077B0 




CALL 


XX99 


3774 00 




07790 ; 


CHECK 


. FOR >4400H MEMORY ADDRESS 


3038 




07800 ; 


GO TC 


I OM ERROR IF NOT ENOUGH 


00000 TOTAL E 


340B £10044 


07810 




LD 


HL,4400H 


1B637 TEXT Al 


340B AF 


07820 




XOR 


A 




340C ED52 


07 830 




SBC 


HL.DE 




34DE D27A19 


07840 




JP 


NC.197AH 






07850 


; TEST 


FOR MEMORY RESET <FBBBH 






07860 


; OM ERROR IF TOO MUCH 




34E1 05 


07B70 




PUSH 


UE 




34E2 E1 


07BB0 




POP 


HL 




34E3 0607 


07 890 




LU 


B,7 




34E5 23 


07900 




INC 


HL 




34E6 10FD 


07910 




DJNZ 


t-1 




34EB 7E 


07920 




LD 


A, IHL) 




34ES 47 


07930 




LD 


6, A 




34EA 2F 


07940 




CPL 






34EB 77 


07S50 




LD 


[HL),A 




34EC BE 


07960 




CP 


IHL) 




34ED C27A1B 


07970 




JP 


NZ.197AH 




34F0 70 


07980 




LD 


(HL),B 






07990 


; PUT I 


<EW MEMORY SIZE INTO PLACE 




34F1 ED53B140 CI 




LD 


f^rjD^ui nr: 






08010 


; TRANSFER KEEPIT DATA ROW 






08020 


; AND PUT NEW ADDRESS IN IY 




34F5 FDE5 


08030 




PUSH 


IY 




34F7 E1 


08040 




POP 


HL 




34F8 13 


08050 




INC 


DE 




34F9 05 


08060 




PUSH 


DE 




34FA F0E1 


08070 




POP 


IY 




34FC 010700 


06080 




LD 


BC,7 




34FF EDBO 


08090 




LDIR 






3501 FDE5 


08100 




PUSH 


IY 




3503 E1 


08110 




POP 


HL 






0B12CJ 


i MAKE FF 


MEM SIZE - 50 DECIMAL 




3504 0632 


08130 




LD 


B.32H 




3506 IB 


08140 


STRING 


DEC 


DE 




3507 10FD 


08150 




DJNZ 


STRING 






08160 


; PUT 


NEW STRING POINTER IN PLACE 




3509 ED53A040 06170 




LD 


(40A0H),DE 




3500 C36C30 


06180 




JP 


GRINS 






08190 


; THIS 


IS LOWER CASE DETERMINATION 




3510 F5 


08200 


LOWER 


PUSH 


AF 




3511 3A1940 


0B210 




LD 


A,(SHIFTR) 




3514 FE01 


08220 




CP 


1 




3516 2B04 


08230 




JR 


Z , L0WEH1 




3518 F1 


08240 




POP 


AF 




3519 C35B04 


06250 




JP 


0458H 




351 C F1 


08260 


L0WER1 


POP 


AF 




3510 DD6E03 


08270 




LD 


L.lIX+3) 




3520 006604 


08280 




LD 


H,[IX+4) 




3523 0A8A04 


08290 




JP 


C.049AH 




3526 007E05 


08300 




LD 


A,(IX+5) 




3529 B7 


08310 




on 


A 




352A 2801 


08320 




JR 


Z.GETCHR 




352C 77 


08330 




LD 


IHL], A 




352D 79 


08340 


GETCHF 


LD 


A,C 




352E FE20 


0B350 




CP 


20H 




3530 DA0605 


08360 




JP 


C.0506H 




3533 FE80 


08370 




CP 


BOH 




3535 D2A604 


06380 




JP 


NC,04A6H 




353B C37D04 


08390 




JP 


047DH 




353B 2A 


08400 


INTR01 


DEFM 


'•FIX ■ SET OEBOUNCE/BEEP/AUTOREPEAT' 


355E OA 


08410 




DEFB 


OAH 




355F 2A 


08420 




DEFM 


'•KILL = RESET TO NORMAL KEYBOARD' 


357F OA 


08430 




DEFB 


OAH 




3580 2A 


08440 




DEFM 


'•MEM = RESET MEMORY 


SIZE [NOTE 1) 


35A1 00 


08450 




OEFB 


DON 




35A2 00 


08460 




DEFB 


OOH 





08470 INTR02 DEFM 

084B0 DEFB 

08480 DEFM 

08600 DEFB 

OB510 DEFM 

08520 DEFB 

08530 DEFM 

08540 DEFB 

08550 DEFB 
OB560 INTR03 DEFM 

08670 DEFB 

08580 DEFM 

08590 DEFB 

08600 DEFM 

08610 DEFB 

08620 DEFM 

08630 OEFB 

08640 DEFB 
08650 INTR04 DEFM 

08660 DEFB 

08670 DEFM 

08680 OEFB 

08690 DEFM 

08700 DEFB 

08710 DEFB 

08720 END 



AAAA 334F 
AAAB 3355 
AAAC 335F 
AAAD 336E 
AAAE 3378 
AAAF 336F 
ABCD 34A6 
AROUND 30DC 
ASCHEX 33A7 
BACKUP 30D3 
BBBA 3335 
BEEEEP 3132 
BEEPER 3163 
BEGIN 3176 
BIPOFF 31 FO 
BLEEEP 31 4F 
BREEK 3367 
BYTE 1D78 



CDEF 32A1 
CLRMEM 309E 
CNTROL 30F8 
CONT02 331 8 
CONTNT 32F5 
DECA 30C6 
DELAY 33CA 
DUMP 325A 
DUMPS9 3422 
EDITOR 3345 
EXECU 344C 
FGHIJ 3213 
FINSH1 327C 
FOUND 30CB 
FREQCY 31 6C 
GETCHR 352D 
GOAWAY 3131 
GRINS 306C 
HEXASC 33 BO 
IIII 3494 
INBEEP 31 FB 
INKEYS 4099 
INTR01 353B 
INTR02 35A3 
INTR03 3642 
INTR04 36D8 
JMPPOS 34BA 
KBPFIX 3085 
KEEPIT 3294 
KEYPRS 3080 
KPLACE 401A 
KYSCAN 03FB 
LLLLS 33C2 
LOWCAS 31 DB 
LOWER 3510 
L0WER1 351 C 
LP99 3465 
LUPER 34BC 
MACH 33F4 
MEMSET 34CE 
MEMTOP 40 B1 
MENU 31 C1 
NAME99 340D 



'•PRINT « LOWERCASE KEYBOARD/DISPLAY ON' 

OAH 

'•OUT « LOWERCASE KEYBOARD/DISPLAY OFF' 

OAH 

'•NEW = RESTORE PROGRAM VICTIM OF NEW' 

OAH 

'•OPEN ■ HEX/ASCII/GRAPHICS MONITOR (NOTE 1)' 

DDH 

OOH 

'•SAVE/RUN ■ SAVE RUNNING PROGRAM (NOTE 2)' 

OAH 

'•SAVE/OPEN = MEMORY BLOCK SAVE (NOTE 3)' 

OAH 

'•STEPXX = SINGLE STEPPER ON, XX = DELAY' 

OAH 

'•STEP = SINGLE STEPPER OFF' 

DDH 

00 

'NOTE 1. REQUIRES 4-CHARACTER HEX VALUE IN QUOTES.' 

OAH 

'NOTE 2. REQUIRES 6-CHARACTER NAME IN QUOTES.' 

OAH 

'NOTE 3. SAME AS ABOVE PLUS HEX STAHT, 

ODH END, OPTIONAL ENTRY' 

OOH 

START 



05030 05000 

05070 05040 

05130 05090 

05230 05190 

05260 05430 

05410 053 BO 

07430 07380 

01400 01360 

05590 05460 05810 05990 06060 

01340 01390 

04830 04890 

01870 

02120 02200 

02260 07710 

02850 02580 

02000 01890 01920 

051 BO 05140 

00390 02330 

03310 

06620 

03660 03890 

00980 01000 

01550 01490 

04630 04740 

04440 04950 05550 

01230 01170 

058B0 05560 

03420 03360 

06450 06360 

04970 05340 05360 05400 05570 

06700 06640 
03000 

03630 03590 

01270 D1090 

02180 02180 

08340 08320 

01860 01520 

00660 08180 

05660 04500 

07290 07210 

02890 02540 

00260 01100 

06400 02650 

08470 02670 

08560 02690 

08650 02710 

07560 07470 07480 

00790 02890 

03800 03760 

00630 00950 

00290 01050 01130 01150 01240 
00270 

05810 05490 06030 06120 

02750 02560 

0B200 02770 

08260 0e23C 

06980 07030 

076D0 07620 

06180 03070 

07740 02520 

00360 03650 

02650 02620 

06330 06370 



02350 02400 03020 03050 03090 03130 
04360 05940 06210 06330 06450 06520 
07180 07360 07740 



01540 01570 01650 01670 01770 
04580 04680 05760 
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NAMES 3245 03310 


03350 






NEXT99 3342 04950 


04420 






NEXTBT 3253 03380 


03330 03400 






NOTRDY 31 7F 02320 


02290 






NXTB89 341 B 06410 


06350 06430 






NXTBCH 328A 03730 


03780 






NXTPGE 3272 03560 


03610 






OKSTAR 31 6D 02400 


02370 






OPENER 32E4 04360 


02480 






OUTSEO. 32C0 04080 


03430 03440 03470 
03820 06990 


03540 


03600 03710 03770 


PORTFF 4030 D02B0 


02070 






PREOUT 328E 04070 


03870 






PHEP2 34B7 07540 


07130 07270 






READY 06CC 00350 


00770 02910 04040 


05210 


07540 


READYX 31FE 02910 


02730 02790 02830 


02870 




RECHEK 3093 00890 


01120 01220 






RENEW 3201 02830 


02460 






RESTRT 4004 00310 


00590 00690 






RRRRS 33B8 05720 


04470 04550 04650 






RSLVII 3076 00730 


03000 






SAVE 3193 02430 








SAVER 3216 03020 


02440 






SETPTS 4000 00370 


03420 






SHIFTR 4019 00300 


00710 01930 01950 


02760 


OB210 


SKPSTP 3176 02250 


00630 07230 07240 






SSSS 3303 05940 


05960 






STACKR 40E8 00330 


03630 






START 3039 00440 


08720 






STEPPR 34BA 07570 








STGEND 40A0 00320 








STNDRD 339F 05550 


05020 05060 05120 


05170 




STPSET 3480 07160 


02500 






STRING 3506 08140 


08150 






STROKE 30AA 01080 


00860 






SYN2 33FD 06230 


06190 06470 






SYN3 34A3 07410 


07760 






SYNERR 31 BE 02630 


02410 03040 03110 


04380 


06230 07410 


TABLET 3121 01780 


01720 






TMWSTE 30C1 01200 


01200 






TTTT 3439 06590 


06540 






UPPPER 31 E8 02810 


02600 






VAREND 40FD 00340 


03490 






VIDEO 3C00 00400 


03840 






WRIT99 3453 06740 


06680 






WRTBYT 0264 00380 


03270 03340 03390 


03920 


03950 03970 04090 




04120 04160 04220 


04280 


04330 06290 06360 




06420 07060 07090 


07110 




WRTPGE 3205 04240 


04300 






XX99 33D1 05930 


04400 06490 06590 


06700 


07780 


Z0429H 30FD 01580 


01450 






Z0435H 3109 01640 


01620 






Z043DH 3111 01680 


01590 






Z0443H 3117 01720 


01700 







KEEPIT 3.2 is a 2K utility program created to 

extend the capabilities of Level II BASIC. It was 
originally sold by The Alternate Source in a RAM- 
based format (version 2.1), and has appeared 
variously from Personal Micro Computers, The 
Peripheral People, and Computer Accessory Tech- 
nology. It is still available from C.A.T., and 
(together with the Memory Sidecar) from MSB 
Electronics, Drawer 766, Barre, Vermont 05641. 
However, since it contains many of the software 
drivers and other routines presented in The Custom 
TRS-80, and represents a complete implementa- 
tion of the custom interpreter (Chapter 3), it is 
offered here as a completely revised version in 
source code format. Its current origin is 3000H, 
for use with the Memory Sidecar project presented 
in Chapter 8. 
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74LS00 



Vcc B4 A4 Y4 B3 A3 Y3 




LI 111 liJ Li LU LU LU 

A1 B1 Y1 A2 B2 Y2 GND 



74LS02 



Vcc Y4 B4 A4 Y3 B3 A3 



^ra 



|_| 111 LU Lj lu lu lu 

Y1 A1 B1 Y2 A2 B2 GND 



74LS04 



Vcc A6 Y6 A5 Y5 A4 Y4 

m nn r ra ra fi rn 






111 111 111 Li lu lu lj 

A1 Y1 A2 Y2 A3 Y3 GND 



74LS08 



Vcc B4 A4 Y4 B3 A3 Y3 

R R R R R R R 




|_J LU LJ LU LU LiJ LU 

A1 B1 Y1 A2 B2 Y2 GND 



Y - AB 
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Vcc C1 Y1 C3 B3 A3 Y3 




LJ UJ LJ LlI LlI l±J LJ 

A1 B1 A2 B2 C2 Y2 GND 



74LS10 



Y - ABC 



Vcc C1 Y1 C3 B3 A3 Y3 74LS11 

R R R R R R R 








U 111 111 Ll LLl LJ LJ 

A1 B1 A2 B2 C2 Y2 GND 



Vcc A6 Y6 A5 Y5 A4 Y4 74LS14 

R R R R R R R 




LJ LJ LJ LJ LLl LJ LJ 

A1 Y1 A2 Y2 A3 Y3 GND 



Y ■ ABCD 



Vcc D2 C2 NC B2 A2 Y2 74LS20 

R R R R R R R 




LU Lil LlI LJ LJ LlI LJ 

A1 B1 NC C1 D1 Y1 GND 
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74LS27 



Vcc C1 Y1 C3 B3 A3 Y3 




LJ LU U LJ LJ LJ LJ 

A1 B1 A2 B2 C2 Y2 GND 



74LS30 



Vcc NC H G NC NC Y 

R R R R R R R 




LJ LJ U LJ LJ LJ LJ 

A B C D E F GND 



Y - ABCDEFGH 



74LS32 



Vcc B4 A4 Y4 B3 A3 Y3 




LJ LJ LJ LJ LJ LJ LJ 

A1 B1 Y1 A2 B2 Y2 GND 



Y« A + B 



74LS74 



Vcc CLR2 D2 CLR2 PRE2 02 02 

R R R R R R R 




LJ LJ LJ LJ LJ LJ LJ 

CLR1 D1 CLK1 PRE1 01 Q1 GND 



INPUTS 


OUTPUTS 


PR 


CLP. CLK 


D 


Q 5 


L 


H X 


X 


H L 


H 


L X 


X 


L H 


L 


L X 


X 


H* H" 


H 


H t 


H 


H L 


H 


H t 


L 


L H 


H 


H L 


X 


QO QO 
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INPUTS 


OUTPUTS 


D G 


Q 


L H 
H H 
X L 


I H 
H L 
do Qo 



H - High Level, L ■ Low Level, X ■ Don't Care 

Qo ■ The Level of Q Before the High-to-Low Transition of G 



ENABLE 
Q1 02 02 1-2 GND 03 03 Q4 



Q1 



d 



FlT 



D1 



D2 3-4 Vcc D3 

ENABLE 



D4 



LJLJLJLJLULULJLU 



04 



74LS75 



INPUTS 


OUTPUT 
Y 


A B 


L L 


L 


L H 


H 


H L 


H 


H H 


L 



Y-A0B-AB + AB 



LS90 

BCD COUNT SEQUENCE 
(See Not* A) 



LS90 

BESET/COUNT TRUTH TABLE 



Q D Qc Ob Q a 



RESET INPUTS 



ROIll R0I2I R9I1I R9I2I 



Q Qc Qa Q A 



COUNT 
COUNT 
COUNT 
COUNT 



LS90BI QUINARY (5-2) 
(See Note Bl 



°A °o °C °B 



Notes: 

(At Output Qa is connected to input B for 

BCD count. 
IB) Output Qd is connected to input A for 

bi-quinarv count. 

(C) Output Qa is connected to input B. 

(D) H = High Level, L - Low Level, X - 
Don't Care. 



LS92 

RESET/COUNT TRUTH TABLE 



RESET INPUTS 


OUTPUT 


R0I1 1 R0I2I 


Q D Qc Ob Q a 


H H 
L X 

X L 


L L L L 
COUNT 
COUNT 



LS92 




COUNT SEOUENCE 




(See Note C) 




COUNT 


OUTPUT 


Q Qc Qb 


Qa 





L L L 


L 


1 


L L L 


H 


2 


L L H 


L 


3 


L L H 


H 


4 


L H L 


L 


5 


L H L 


H 


6 


H L L 


L 


7 


H L L 


H 


8 


H L H 


L 


9 


H L H 


H 


10 


H H L 


L 


11 


H H L 


H 



Vcc B4 A4 Y4 B3 A3 Y3 

r m fi m r m m 




LJ LJ Lll LU HI LJ LJ 

A1 B1 Y1 A2 B2 Y2 GND 



INPUT 

A NC Qa Od GND Qb Qc 

r r r r r r m 



) I r 



LJ LJ LU LJ LU LJ LJ 

B ROM) R0I2) NC Vcc R9(1) R9I2) 
INPUT 




lj LJ u LJ Ld LJ LJ 



B NC NC NC Vcc R0I1) R0(2) 
INPUT 



74LS86 



74LS90 



74LS92 
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74LS93 



74LS125 



74LS154 



INPUT 

A NC 



Qa Qd GND Qb Qc 

R_ M. HD_ M HiL HL in. 



COUNT SEQUENCE 
(See Note C) 




B ROM) P.012) NC 

INPUT 



COUNT 


OUTPUT 


°0 


Qc Qg 


Q» 





L 


L L 


L 


1 


L 


L L 


H 


2 


L 


L H 


L 


3 


L 


L H 


H 


4 


L 


H L 


I 


5 


L 


M L 


H 


6 


L 


H H 


L 


7 


L 


H H 


H 


e 


H 


L L 


L 


9 


H 


L L 


H 


10 


H 


L H 


L 


11 


H 


L H 


H 


12 


H 


H L 


L 


13 


H 


H L 


H 


14 


H 


H H 


l 


15 


H 


H H 


H 



LS93 
Notes: 

(A) Output Qa is connected to input B for 
BCD count. 

(B) Output Qq is connected to input A for 
biquinary count. 

(C) Output Qa is connected to input B 
(Dl H = High Level, L - Low Level, X ■ 

Don't Care. 



INPUTS 



OUTPUTS 



VCC 



G2 Gl 15 14 



13 



12 11 



rr^rrhhrrrrfi 



)r° 



6 



6 6 



6_£ 



o 



o 



0- 1 











LIliJLllLJlAjlijLlJlijLlJHLlJLil 



10 



GND 



OUTPUTS 



INPUTS 


OUTPUTS 


Gl 


G2 


D C 


B 


A 





1 


2 


3 


4 


5 


6 


7 8 


9 


10 


11 


12 


13 


14 


15 


I 


I 


L L 


L 


L 


L 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


I 


L 


L L 


L 


H 


H 


L 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


L 


L 


L L 


H 


L 


H 


H 


L 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


M 


H 


I. 


L 


L L 


H 


H 


H 


H 


H 


I 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


1 


L 


L H 


L 


L 


H 


H 


H 


H 


L 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


1 


L 


L H 


L 


H 


H 


H 


H 


H 


H 


L 


H 


H H 


H 


H 


H 


H 


II 


H 


H 


L 


L 


L H 


H 


1 


H 


H 


H 


H 


H 


H 


L 


H H 


H 


H 


H 


H 


H 


H 


H 




L 


L H 


H 


H 


H 


H 


H 


H 


H 


H 


H 


L H 


H 


H 


H 


H 


H 


H 


H 




L 


H L 


L 


L 


H 


H 


H 


H 


H 


H 


H 


H L 


H 


H 


H 


H 


H 


H 


H 


I 


L 


H L 


L 


H 


H 


H 


H 


H 


H 


H 


h 


H H 


L 


H 


H 


H 


h 


H 


H 


i 


L 


H L 


H 


L 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


L 


H 


H 


H 


H 


H 


L 


L 


H L 


H 


H 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


L 


H 


H 


H 


H 


1 


L 


H H 


L 


L 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


I- 


L 


H 


H 


ri 


L 


L 


H H 


I 


H 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


L 


H 


H 


I 


L 


H H 


H 


L 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


L 


H 


L 


I 


H H 


H 


H 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


I 


L 


H 


X X 


X 


X 


H 


H 


H 


H 


11 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


V' 


H 


L 


X X 


X 


X 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


H 


H 


X X 


X 


X 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 



H - High Level, L - Low Level, X - Don't Care 
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INPUTS 


OUTPUT 
V 


A C 


H L 
L L 
X H 


H 

L 
H, Z 



Vcc C4 A4 Y4 C3 A3 Y3 

r r r r r r r 



74LS125 




C1 A1 Y1 C2 A2 Y2 6ND 



74LS154 





INPUTS 


OUTPUT V 


STROBE 


SELECT 


A 


B 


157. L157A 
LS1S7. S157 


LS1SS 
S158 


H 


X 


X 


X 


L 


H 


L 


L 


L 


X 


L 


H 


L 


L 


H 


X 


H 


L 


L 


H 


X 


I 


L 


H 


L 


H 


X 


H 


H 


L 



H = High Level, L = Low Level, X - Don't Cere 



INPUTS 



INPUTS 



STROBE f 

Vcc G A4 



B4 



OUTPUT, 
Y4 



OUTPUT 
Y3 



74LS157 



RRRRRRRR 



I 










).- J 


• 











LJLUlJJLlJLllLJLJLLJ 

S A1 B1 Y1 A2 B2 Y2 GND 

SELECT^ v CAJTPUT ^ v ' OUTPUT 

INPUTS INPUTS 



INPUTS 


INTERNAL 
OUTPUTS 


OUTPUT 


CLEAR 


SHIFT/ 
LOAD 


CLOCK 
INHIBIT 


CLOCK 


SERIAL 


PARALLEL 


A . . . H 


Oa Q b 


L 
H 
H 
H 
H 
H 


X 
X 
L 
H 
H 
X 


X 
L 

L 
L 
L 
H 


X 
L 

t 


X 
X 
X 
H 
L 
X 


X 
X 
a . .h 
X 
X 
X 


L L 

Qao 0-bo 

a b 
H A „ 
L 0*„ 

QflO "BO 


L 

Q„o 
h 

°G» 
Oho 



H = High Level (steady state), L = Low Level (steady state) 

X ■ Don't Care (any input, including transitions) 

t = Transition from low to high level 

a . . . h = The level of steady-state input at inputs A through H, respectively. 

Q A0- Q B0- Q H0 = Tne level of Q A- Q B or Q H- respectively, before the indicated 

steady-state input conditions were established. 

^An- ^Gn = Tn e 'eve' of Qa or ^G- respectively, before the most recent 1 transition 

of the clock 



PAR 

SHIFT/ INP OUTPUT 

LOAD H Qh 



PARALLEL 
INPUTS 



Vcc LOAD H un 6 F E 

R R R R R R R 



74LS166 

CLEAR 



)r- J 

_ ■ ■ A 



LULULULULiJLJLJLiJ 



SERIAL 
INPUT 



^ 



PARALLEL INPUTS 



CLOCK CLOCK 
INHIBIT 



GND 
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74LS174 



Vcc 06 D6 D5 05 D4 04 CLOCK 




ULJlJJLULllLJLJLiJ 

CLEAR 01 D1 D2 02 D3 03 GND 



INPUTS 


OUTPUTS 


CLEAR 


CLOCK 


D 


Q Q' 


L 


X 


X 


L H 


H 


t 


H 


H L 


H 


t 


L 


L H 


H 


L 


X 


Qo Co 



H - High Level (steady state) 

L ■ Low Level (steady state) 

X = Don't Care 

t = Transition from low to high level 

Qq = The level of Q before the indicated steady-state input 

conditions were established, 
t ■ 175, LS175, andS175 only 



74LS260 



Vcc E1 



D1 



E2 D2 C2 



B2 



r r r r r m m 




Y2 GND 



V - A+B+C+D+E 



Vcc G2 A6 Y6 A5 Y5 A4 Y4 

RRRRRRRR 



rrrro 



>t> 



Pi pi 




ULiJIiJLjULllULiJ 

G1 A1 Y1 A2 Y2 A3 Y3 GND 



INPUTS 


OUTPUT 
V 


G1 G2 A 


H X X 
X H X 

L L H 

L L L 


2 
Z 
H 
L 
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INPUTS 


OUTPUT 

V 


G1 G2 A 


H X X 
X H X 
L L H 
L U L 


z 
z 

L 
H 



Vcc G2 A6 Y6 A5 Y5 A4 Y4 



y y y 



.fTnViVi 



LJLllLJLLlLiiLiJLJLiJ 

G1 A1 Y1 A2 YE A3 Y3 GND 



74LS366 



INPUTS 


OUTPUT 
Y 


G A 


H X 
L H 
L L 


z 

H 
L 



Vcc G2 A6 Y6 A5 Y5 A4 Y4 






Y_Y 



k>J 



ESS 



UlilLilLlLiJLiJLlJLU 

G1 A1 Y1 A2 Y2 A3 Y3 GND 



74LS367 



INPUTS 


OUTPUT 
Y 


G A 


H X 
L H 
L L 


Z 
L 
H 



Vcc G2 AB Y6 A5 Y5 A4 Y4 




ULJLllLLlLiJLiJLJLLl 

G1 A1 Y1 A2 Y2 A3 Y3 GND 



74LS368 
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74LS373 



Vcc OB D8 D7 Q7 06 D6 D5 05 CLOCK 




UmUJLULULllLJLllLlILd 



OUTPUT 01 D1 C2 02 03 D3 D4 04 GND 

CTRL A 



HA\ ^ZfVlA. Vcc m D8 D7 Q7 06 D6 D5 05 CLOCK 




LJLULJLJLULiJLJLLlLlJLU 



OUTPUT 01 D1 C2 02 03 D3 D4 04 GND 

CTRL A 



OUTPUT 
CONTROL 


CLOCK 


D 


OUTPUT 


L 


H 


H 


H 


L 


H 


L 


L 


L 


L 


X 


00 


H 


X 


X 


z 



OUTPUT 
CONTROL 


CLOCK 


D 


OUTPUT 


L 
L 
L 
H 


t 
t 
L 
X 


H 
L 
X 
X 


H 
L 
00 

2 



80C96 



Vcc G2 A6 Y6 A5 Y5 A4 Y4 

RRRF1F1RRF1 




LJULJLllLJLllLJLLl 

G1 A1 Y1 A2 Y2 A3 Y3 GND 



INPUTS 


OUTPUT 


Gl G2 A 


V 


H X X 
X H X 

L L H 
L L L 


HiZ 
HiZ 

L 
H 
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INPUTS 


OUTPUT 


G A 


Y 


H X 
L H 

L L 


HiZ 
L 
H 



INPUTS 


OUTPUT 
Y 


G1 G2 A 


H X X 
X H X 
L L H 
L L L 


2 

Z 
H 

L 



INPUTS 


OUTPUT 
Y 


Gl G2 A 


H X X 
X H X 
L L H 
L L L 


Z 
Z 
L 
H 



Vcc G2 A6 YB A5 Y5 A4 Y4 




L_J Lil Lll LJ LJ LJ LJ Ld 

G1 A1 Y1 A2 Y2 A3 Y3 GND 



Vcc G2 A8 YB A7 Y7 A6 YB A5 Y5 



cyrcypJ^ 



)£> 




^rtf^rth 



UljJliJIJJLiJLiJLjl-iJLilLii 

G1 A1 Y1 A2 Y2 A3 Y3 A4 Y4 GND 




>£> 



CV 



r^^rblJOn 



LJUJLJLLlLlJLJlJJLiJLLlLaJ 

G1 A1 Y1 A2 Y2 A3 Y3 A4 Y4 GND 



80C98 



81LS95 



Vcc G2 A8 Y6 A7 Y7 A6 Y6 A5 Y5 81LS96 
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m c 
re r 

Al C 

esns c 
Birr c 

B*L2 c 

sirs c 
djo c 

DATs c 
CITS C 

0Al7 C 
PRT/STEP C 

ShJ'CNRC C 
pmj C 

3PM C 

5R c 



40 
19 

a 

36p 

35 
34 
33 
32h 



30 J 

28{") 
27 

26 

»h 



23b 
22 

21 



3 v 00 (. i2vi 

n INTRO 

1 dro 

D DINT 
WPRT 

1 TROO 

SF 

READY 
3 WD 

NO 

TG43 

MLD 
3 FODATA 
J FDCIK 

XTDS 
3 CLK 

HLT 
3 TRT 
3 "C i-»vi 



PIN CONNECTIONS 



K 



COMPUTER 
INTERFACE 



^ 



OS 



we 

MR 




FLOPPY DISK 
CONTROLLER 
FORMATTER 



SS^BB V OD V CC 



3P"M 



^1 



X 



ONE SHOT 
IlF USED) 



FLOPPY 

DISK 

DRIVE 



FD1771 SYSTEM BLOCK DIAGRAM 



.'fast, DA'A 
SEPARATION *D0 1O 

Miisf B{ fifp unit. 



,._Fl_ 




'NTEBN*l.DA t *«P*»*'iON M»r-*URK ^O" SOME-iMt-PUO'iONS «OWEvfR 

fon APPiicAiiONsntouiniMG high d»tah( cover* ntL-Afliutt 

*DC »ECOWM£NOSE»lfBN*i HA 'A SEPARATION BE USED 



READ TIMING (XTDS = 1) 



■H 'c« f- 




WON I c . ^ 

VOl 1 



->h 



_n_n^ rL_n 



MISCELLANEOUS TIMING 
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PIN OUTS 



Pin No. 


Pin Name 


Symbol 


Function 


1 


Power Supplies 


Vrb/nc 

MR 


-5V 


19 


MASTER RESET 


A logic low on this input resets the device and loads 








"03" into the command register. The Not Ready 








(Status bit 7) is reset during MR ACTIVE. When MR" 








is brought to a logic high, a Restore Command is 








executed, regardless of the state of the Ready signal 








from the drive. 


20 




vss 


Ground 


21 




v C c 


+5V 


40 




VDD 


+ 12V 


Computer l 


nterface 






2 


WRITE ENABLE 


WE 


A logic low on this input gates data on the DAL into 


3 




CS 


the selected register when CS is low. 

A logic low on this input selects the chip and enables 


CHIP SELECT 


4 




RE 


computer communication with the device. 

A logic low on this input controls the placement of 


READ ENABLE 








data from a selected register on the DAL when CS is 
low. 


5,6 


REGISTER SELECT 


Ao, Ai 


These inputs select the register to receive/transfer 




LINES 




data on the DAL lines under RE and WE control: 
Ai Ao RE WE 
Status Register Command Register 

1 Track Register Track Register 

1 Sector Register Sector Register 


7-14 






1 1 Data Register Data Register 
Eight bit inverted bidirectional bus used for transfer 


DATA ACCESS LINES 


DAL0-DAL7 








of data, control, and status. This bus is a receiver 








enabled by WE or a transmitter enabled by RE. 


24 


CLOCK 


CLK 


This input requires a free-running 2 MHz ±1% square 
wave clock for internal timing reference. 


38 


DATA REQUEST 


DRQ 


This open drain output indicates that the DR con- 
tains assembled data in Read operations, or the DR 
is empty in Write operations. This signal is reset 
when serviced by the computer through reading or 
loading the DR in Read or Write operation, respec- 
tively. Use 10K pull-up resistor to +5. 


39 


INTERRUPT REQUEST 


INTRQ 


This open drain output is set at the completion or 
termination of any operation and is reset when a 
new command is loaded into the command register. 
Use 10K pull-up resistor to +5. 


Floppy Oit I 


[ Interface: 






15 


Phase 1/Step 


PTfl/STEP 


If the 3PM input is a logic low the three-phase motor 
control is selected and PH1, PH2, and PH3 outputs 
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Pin No. 


Pin Name 


Symbol 


Function 


16 




PH2/DIRC 


formaoneactivelowsignaloutofthree. PH1 isactive 


Phase 2/Direction 








low after MR. If the 3PM input is a logic high the step 


17 


Phase 3 


PH3 


and direction motor control is selected. The step 


18 




3PM 


output contains a 4 usee high signal for each step 
and the direction output is active high when stepping 


3-Phase Motor Select 


22 






in; active low when stepping out. 

This input is used for testing purposes only and 


TEST 


TEST 








should be tied to +5V or left open by the user. 


23 


HEAD LOAD TIMING 


HLT 


The HLT input is sampled after 10 ms. When a logic 
high is sampled on the HLT input the I iead is assumed 


25 






to be engaged. 

A logic low on this input selects external data 


EXTERNAL DATA 


XTDS 




SEPARATION 




separation. A logic high or open selects the internal 
data separator. 


26 


FLOPPY DISK CLOCK 


FDCLOCK 


This input receives the externally separated clock 




(External Separation) 




when XTDS = 0. If XTDS = 1, this input should be tied 


27 


FLOPPY DISK DATA 


FDDATA 


to a logic high. 


This input receives the raw read disk data if XTDS=1, 








or the externally separated data if XTDS=0. 


28 


HEAD LOAD 


HLD 


The HLD output controls the loading of the Read- 
Write head against the media. 


29 


Track Greater than 43 


TG43 


This output informs the drive that the Read-Write 
head is positioned between tracks44-76. This output 
is valid only during Read and Write commands. 


30 


WRITE GATE 


WG 


This output is made valid when writing is to be per- 
formed on the diskette. 


31 


WRITE DATA 


WD 


This output contains both clock and data bits of 
500 ns duration. 


32 


Ready 


READY 


This input indicates disk readiness and is sampled 
for a logic high before Read or Write commands are 
performed. If Ready is low, the Read or Write oper- 
ation is not performed and an interrupt is generated. 
A Seek operation is performed regardless of the state 
of Ready. The Ready input appears in inverted format 


33 




WF 


as Status Register bit 7. 

This input detects wiring faults indications from the 


WRITE FAULT 








drive. When WG=1 and WF goes low, the current 








Write command is terminated and the Write Fault 








status bit is set. The WF input should be made inactive 


34 






(high) when WG becomes inactive. 

This input informs the FD1771 that the Read-Write 


TRACK 00 


TR00 
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IP 


head is positioned over Track 00 when a logic low. 
Input, when low for a minimum of 10 usee, informs 


INDEX PULSE 








the FD1771 when an index mark is encountered on 
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the diskette. 

This input is sampled whenever a Write command is 


WRITE PROTECT 


WPRT 








received. A logic low terminates the command' and 


37 






sets the Write Protect status bit. 

The iput is sampled whenever a Write Track com- 


DISK INITIALIZATION 


DINT 








mand is received. If DINT=0, the operation is termin- 








ated and the Write Protect status bit is set. 
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COMMAND DESCRIPTION 

The FD1771 will accept and execute eleven com- 
mands. Command words should only be loaded in 
the Command Register when the Busy status bit is 
off (status bit 0). The one exception is the Force 
Interrupt command. Whenever a command is being 
executed, the Busy status bit is set. When a com- 
mand is completed, an interrupt is generated and the 
Busy status bit is reset. The Status Register indicates 
whether the completed command encountered an 

error or was fault-free. For ease of discussion, com- 
mands are divided into four types. Commands and 
types are summarized in Table 2. 

TYPE 1 COMMANDS 

The Type 1 Commands include the RESTORE, 
SEEK, STEP, STEP-IN, and STEP-OUT commands. 
Each of the Type 1 Commands contain a rate field 
(rrjri ). which determines the stepping motor rate as 
defined in Table 1, page 4. 

The Type 1 Commands contain a head load flag (h) 
which determines if the head is to be loaded at the 

Table 2. COMMAND SUMMARY 



Table 4. FLAG SUMMARY 





BITS 


TYPE 


COMMAND 


7 6 5 4 3 2 10 


II 

II 

III 

III 

III 

IV 


Restore 
Seek 
Step 
Step In 
Step Out 
Read Command 
Write Command 
Read Address 
Read Track 
Write Track 
Force Interrrupt 


000 h Vr,r 
1 h V n r 
1 u h V M r 
1 u h V ri r 

1 1 u h V ri r 
10 1 10 
10 1O1 1 O a 

1 1 E 
1110 10s 
1 1 1 10 1 
1 1 1 l 3 l 2 h U 



Note: Bits shown in TRUE form. 

Table 3. FLAG SUMMARY 



TYPE 



h = Head Load flag (Bit 3) 
h = 1, Load head at beginning 
h = 0, Do not load head at beginning 

V = Verify flag (Bit 2) 

V = 1 , Verify on last track 

V = 0, No verify 

Stepping motor rate (Bits 1-0) 



h r 



Refer to Table 1 for rate summary 
u = Update flag (Bit 4) 
u = 1, Update Track register 



u = 0, No update 



TYPE II 



m = Multiple Record flag (Bit 4) 

m=0, Single Record 
m=1. Multiple Records 

b = Block length flag (Bit 3) 

b=1, IBM format (128 to 1024 bytes) 
b=0, Non-IBM format (16 to 4096 bytes) 

a ia = Data Address Mark (Bits 1-0) 

aia = 00, FB (Data Mark) 
a-|ao= 01, FA (User defined) 
aiao= 10, F9 (User defined) 
aiao= 11, F8 (Deleted Data Mark) 



Tables. FLAG SUMMARY 



TYPE III 



s = Synchronize flag (Bit 0) 

s=0, Synchronize to AM 

5=1, Do Not Synchronize to AM 



TYPE IV 



li = 

'0=1 

h=i 
I 2 =1 

'3=1 



Interrupt Condition flags (Bits 3-0) 
Not Ready to Ready Transition 
Ready to Not Ready Transition 
Index Pulse 
Immediate interrupt 



E = Enable HLD and 10 msec Delay 
E=1, Enable HLD, HLT and 10 msec Delay 
E=0. Head is assumed Engaged and there is 
no 10 msec Delay 



beginning of the command. Ifh=1, the head is 
loaded at the beginning of the command (HLD 
output is made active). If h=0, HLD is deactivated. 
Once the head is loaded, the head will remain 
engaged until the FD1771 receives a command that 
specifically disengages the head. If the FD1771 
does not receive any commands after two 
revolutions of the disk, the head will be auto- 
matically disengaged (HLD made inactive). The 
Head Load Timing Input is sampled after a 10 ms 
delay, when reading or writing on the disk is to 
occur. 

The Type 1 Commands also contain a verification 
(V) flag which determines if a verification operation 
is to take place on the destination track. If V=1 , a veri- 
fication is performed; if V=0, no verification is 
performed. 

During verification, the head is loaded and after an 
internal 10 ms delay, the HLT input is sampled. When 
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ELECTRICAL CHARACTERISTICS 

Maxium Ratings 

Vqd with respect to Vbb (Ground) +20 to -0.3V 
Max Voltage to any input with +20 to -0.3V 

respect to Vbb 
Operating Temperature 0° C to 70° C 

Storage Temperature -55°C to +125°C 



OPERATING CHARACTERISTICS (DC) 

Ta = 0°C to 70°C, Vqd = +12.0V + 6V, 

Vbb = -5.0 ± 5V, Vss = 0V. VCC = +5V ± 25V 

I DO = 10 ma Nominal, Ice = 30 ma Nominal, 

I BB = 0.4 pa Nominal 



Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


ILI 


Input Leakage 






10 


MA 


V|N = Vdd 


lLO 


Output Leakage 






10 


*iA 


VouT sV DO 


V|H 


Input High Voltage 


2.6 






V 




V|L 


Input Low Voltage (All Inputs) 






0.8 


V 




VOH 


Output High Voltage 


2.8 






V 


lO x -100uA 


vol 


Output Low Voltage 






0.45" 


V 


10 = 1.0 mA 



'Write Gate Vql < 0.5V. 



TIMING CHARACTERISTICS 

TA 



'BB 



0°C to 70° C, V DD = +12V ± .6V, 

= -5V ± 25V, V ss = 0V, V cc = +5V ± .25V 



NOTE: Timings are given for 2 MHz Clock. For those 
timings noted, values will double when chip is oper- 
ated at 1 MHz. Use 1 MHz when using mini-floppy. 



Read Operations 














Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TSET 


Setup ADDR and CS to RE 


100 






nsec 






THLD 


Hold ADDR and CS from RE 


10 






nsec • 






TRE 


RE Pulse Width 


500 






nsec 


C L = 25 pf 




TDRR 


DRO Reset from R~E 






500 


nsec 






TIRR 


INTRO Reset from RE 






3000 


nsec 






TDACC 


Data Access from RE 






450 


nsec 


C L = 25 pf 




TDOH 


Data Hold from Rl 


50 




150 


nsec 


C L = 25 pf 





Write Operations 












Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TSET 


Setup ADDR and CS to WE 


100 






nsec 


: 


THLD 


Hold ADDR and CS from WE 


10 






nsec 


• 


TWE 


WE Pulse Width 


350 






nsec 


y > 


TDRR 


DRQ Reset from WE 






500 


nsec 




TIRR 


INTRO Reset from WE 






3000 


nsec 


See Note 


TDS 


Data Setup to WE 


250 






nsec 


• 


TDH 


Data Hold from WE 


150 






nsec 


I 



External Data Separation (XTDS = 0) 



Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TPWX 


Pulse Width Read Data & Raad Clock 


150 




350 


nsec 




TCX 


Clock Cycle External 


2500 






nsec 




TDEX 


Data to Clock 


500 






nsec 




TDDX 


Data to Data Cycle 


2500 






nsec 
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1. 


OROVOL ' 

1 


~ 1 








VOL 






"1 


[— IMtVK* — 


HID* 


u 


"1_ 








AO ai CS 




— — 


1 








T SET 










1 


1 


DATA VALID iBUl 

READ DATA 

(BUFFERS TRI-STAT6DI 

NOTE 

1 C"SMAY BE permanently I 
I FOR READ TRACK COMMAND 
3 WncaWOnSTCASEKuSCC 
"TIME DOUBLES WHEN Cm i 


' DACC 

ED LOW IF OE SiRED 
This TIME MAV BE i 

MH2 


h- 

DOM 

■ TO 3? 


ItSEC WHEN & D 



Hz 



- u 



NOTE 

i £s" MAV BE PERMANENTLY t>ED LOW IF DESIRED 

1 WHEN WRITING DATA INTO 'HIS SECTOR TRACK OR DATA REGISTER USER CANNOT 
HE AO 'HIS REGISTER UNTIL AT LEAST • JiSEC AFTER T« E RISING EDGE OF WE" WHEN 
WRITING INTO The COMMAND REGISTER STATUS IS NOT VALiO UNTii SOME MuSE C 
LATER THESE TIMES ARE DOUBLED WHEN CLK 1 MHZ 

1 'tww* WORST CASE 14 (j SEC 

■ TIME OOUBLES WHEN CLK i Hh; 



READ ENABLE TIMING 



WRITE ENABLE TIMING 




NOTE 

1 ABOVE TIMES ARE DOUBLED WHEN CLK 1 MHi 

2 CONTACT WOC FOR EXTERNAL CLOCK-DATA SEPARATOR CIRCUITS 

3 FDClk ANDFOOATAMAT BE R€VE«SEO FOi r71 DECiDtS WHAT IS CLOCK AND WHAT IS DATA 



Internal Data Separation (XTDS = 1) 



READ TIMING (XTDS - 0) 



Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TPWI 
TCI 


Pulse Width Data and Clock 
Clock Cycle Internal 


150 
3500 




1000 
5000 


nsec 
nsec 





Write Data 


Timing 












Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TWGD 


Write Gate to Data 




1200 




nsec 


300 nsec ± CLK tolerance 


TPWW 


Pulse Width Write Data 


500 




600 


nsec 




TCDW 


Clock to Data 




2000 




nsec 


± CLK tolerance 


TCW 


Clock Cycle Write 




4000 




nsec 


± CLK tolerance 


TWGH 


Write Gate Hold to Data 







100 


nsec 





Miscellaeous Timing 



Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TCDt 


Clock Duty 


175 






nsec 


2 MHz ± 1% See Note 


TCD 2 


Clock Duty 


210 






nsec 




TSTP 


Step Pulse Output 


3800 




42O0 


nsec 


1 


TDIR 


Direct Setup to Step 


24 






usee 




TMR 


Master Reset Pulse Width 


10 






usee 


These times doubled 


TIP 


Index Pulse Width 


10 






usee 


when CLK = 1 MHz 


TWF 


Write Fault Pulse Width 


10 






usee 
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Mode Definition Summary Table 



Poft 
Bits 



PA C 
PA, 
PA, 
PA 3 
PA 4 
"A,, 
p A 6 
PA, 



PB 
PB, 
PB 2 
PB 3 
PB, 
PB 5 
PB 6 
PB, 



p C 
PC, 
PC, 
PC, 
PC 4 
p ^5 
PC fi 
PC 7 



IN 

IN 

IN 

IN 
IN 

IN 
IN 
IN 



IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 



IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 



OUT 



OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 



OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 



OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 



OUT 



IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 



IN 
IN 
IN 
IN 
IN 
IN 
IN 
IN 



INTR B 
IBF B 
STB B 
INTR A 
STB A 
IBF A 
I 
I/O 



OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 



OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 



INTR B 

w, 

ACK B 
INTR A 

I/O 

10 
ACK A 
OBFa 



Mode 2 



Group A Only 



Bidirectional 

i 



(Mode or Mode 1 only) 



I/O 
I/O 

10 
INTR A 
STB A 
'BF A 
ACK A 
0BF A 



Physical Dimensions 
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Z80-CPU 
Z80A-CPU 




Zilog 



The Zilog Z80 product line is a complete set of micro- 
computer components, development systems and support 
software. The Z80 microcomputer component set includes 
all of the circuits necessary to build high-performance 
microcomputer systems with virtually no other logic and a 
minimum number of low cost standard memory elements. 

The Z80 and Z80A CPU's are third generation single chip 
microprocessors with unrivaled computational power. This 
increased computational power results in higher system 
through-put and more efficient memory utilization when 
compared to second generation microprocessors. In 
addition, the Z80 and Z80A CPU's are very easy to imple- 
ment into a system because of their single voltage require- 
ment plus all output signals are fully decoded and timed to 
control standard memory or peripheral circuits. The circuit 
is implemented using an N-channel, ion implanted, silicon 
gate MOS process. 

Figure 1 is a block diagram of the CPU, Figure 2 details 
the internal register configuration which contains 208 bits 
of Read/Write memory that are accessible to the program- 
mer. The registers include two sets of six general purpose 
registers that may be used individually as 8-bit registers or 
as 16-bit register pairs. There are also two sets of accumu- 
lator and flag registers. The programmer has access to either 
set of main or alternate registers through a group of ex- 
change instructions. This alternate set allows foreground/ 
background mode of operation or may be reserved for very 
fast Interrupt response. Each CPU also contains a 16-bit 
stack pointer which permits simple implementation of 



Product Specification 



MARCH 1978 



multiple level interrupts, unlimited subroutine nesting and 
simplification of many types of data handling. 

The two 16-bit index registers allow tabular data manipu- 
lation and easy implementation of relocatable code. The 
Refresh register provides for automatic, totally transparent 
refresh of external dynamic memories. The I register is used 
in a powerful interrupt response mode to form the upper 8 
bits of a pointer to a interrupt service address table, while 
the interrupting device supplies the lower 8 bits of the 
pointer. An indirect call is then made to this service address. 



FEATURES 

• Single chip, N-channel Silicon Gate CPU. 

• 1 58 instructions-includes all 78 of the 8080A instruc- 
tions with total software compatibility. New instruc- 
tions include 4-, 8- and 16-bit operations with more 
useful addressing modes such as indexed, bit and relative. 

• 17 internal registers. 

• Three modes of fast interrupt response plus a non- 
maskable interrupt. 

• Directly interfaces standard speed static or dynamic 
memories with virtually no external logic. 

• 1 .0 /us instruction execution speed. 

• Single 5 VDC supply and single-phase 5 volt Clock. 

• Out-performs any other single chip microcomputer in 
4-, 8-, or 16-bit applications. 

• All pins TTL Compatible 

• Built-in dynamic RAM refresh circuitry. 




INSTRUCTION 

DECODE 

AND 

CPU 

CONTROL 



Z80, Z80A CPU BLOCK DIAGRAM 
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Z80, Z80A-CPU Pin Description 
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RFSH 
(Refresh) 



HALT 
(Halt state) 



Z80, Z80A CPU PIN CONFIGURATION 

Aq -A15 Tri-state output, active high. Aq-A]5 

(Address Bus) constitute a 16-bit address bus. The 
address bus provides the address for 
memory (up to 64K bytes) data 
exchanges and for I/O device data exchanges. 



Dq -D7 Tri-state input/output, active high. 

(Data Bus) Dq - D7 constitute an 8-bit bidirectional 

data bus. The data bus is used for data 
exchanges with memory and I/O devices. 



WAIT 
(Wait) 



INT 

(Interrupt 

Request) 



Output, active low. RFSH indicates that 
the lower 7 bits of the address bus con- 
tain a refresh address for dynamic 
memories and the current MREQ signal 
should be used to do a refresh read to all 
dynamic memories. 



Output, active low. HALT indicates that 
the CPU has executed a HALT software 

instruction and is awaiting either a non- 
maskable or a maskable interrupt (with 
the mask enabled) before operation can 
resume. While halted, the CPU executes 
NOP's to maintain memory refresh 
activity. 



Input, active low. WAIT indicates to the 
Z-80 CPU that the addressed memory or 
I/O devices are not ready for a data 
transfer. The CPU continues to enter wait 
states for as long as this signal is active. 

Input, active low. The Interrupt Request 
signal is generated by I/O devices. A 
request will be honored at the end of the 
current instruction if the internal soft- 
ware controlled interrupt enable flip-flop 
(IFF) is enabled. 



M] 

(Machine 
Cycle one) 



MREQ 

(Memory 
Request) 



IORQ 

(Input/ 
Output 
Request) 



RD 

(Memory 
Read) 



WR 

(Memory 
Write) 



Output, active low. M[ indicates that the 
current machine cycle is the OP code 
fetch cycle of an instruction execution. 



Tri-state output, active low. The memory 
request signal indicates that the address 
bus holds a valid address for a memory 
read or memory write operation. 



Tri-state output, active low. The IORQ 
signal indicates that the lower half of the 
address bus holds a valid I/O addr ess for 
a I/O read or write operation. An IORQ 
signal is also generated when an interrupt 
is being acknowledged to indicate that an 
interrupt response vector can be placed 

on the data bus. 



Tri-state output, active low. RD indicates 
that the CPU wants to read data from 
memory or an I/O device. The addressed 
I/O device or memory should use this 
signal to gate data onto the CPU data bus. 



Tri-state output, active low. WR indicates 
that the CPU data bus holds valid data to 
be stored in the addressed memory or I/O 
device. 



NMI 
(Non 
Maskable 
Interrupt) 



RESET 



BUSRQ 

(Bus 

Request) 



BUSAK 
(Bus 

Acknowledge) 



Input, active low. The non-maskable 
nter rupt request line has a higher priority 
than INT and is always recognized at the 
end of the current instruction, indepen- 
dent of t he sta tus of the interrupt enable 
flip-flop. NMI automatically forces the 
Z-80 CPU to restart to location 0066^. 



Input, active low. RESET initializes the 
CPU as follows: reset interrupt enable 
flip-flop, clear PC and registers I and R 
and set interrupt to 8080A mode. During 
reset time, the address and data bus go to 
a high impedance state and all control 
output signals go to the inactive state. 

Input, active low. The bus request signal has 
a higher priority than NMI and is always rec- 
ognized at the end of the current machine 
cycle and is used to request the CPU address 
bus, data bus and tri-state output control 
signals to go to a high impedance state so 
that other devices can control these busses. 

Output, active low. Bus acknowledge is 
used to indicate to the requesting device 
that the CPU address bus, data bus and 
tri-state control bus signals have been set 
to their high impedance state and the 
external device can now control these signals. 
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Timing Waveforms 



INSTRUCTION OP CODE FETCH 



The program counter content (PC) is placed on the 
address bus im mediately at the start of the cycle. One half 
clock t ime later MREQ goes active. The falling edge of 
MREQ can be used directly as a chip enable to dynamic 
memories. RD when active indicates that the memory 
data should be enabled onto the CPU data bus. The CPU 
samples data with the rising edge of the clock state T3. 
Clock states T3 and T4 of a fetch cycle are used to refresh 
dynamic memories while the CPU is internally decoding 
and executing the instruction. The refresh control signal 
RFSH indicates that a refresh read of all dynamic memories 
should be accomplished. 




MEMORY READ OR WRITE CYCLES 



Illustrated here is the timing of memory read or write 
cycles other than an OP code fetch (Mj cycle). The MREQ 
and RD signals are used exactly as in t he fetc h cycle. In 
the case of a memory write cycle, the MREQ also becomes 
active when the address bus is stable so that it can be used 
directly as a chip enable for dynamic memories. The WR 
line is active when data on the data bus is stable so that it 
can be used directly as a R/W pulse to virtually any type of 
semiconductor memory. 
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INPUT OR OUTPUT CYCLES 



Illustrated here is the timing for an I/O read or I/O write 
operation. Notice that during I/O operations a single wait 
state is automatically inserted (Tw*). The reason for this is 
that during I/O operations this extra state allows sufficient 
time for an I/O port to decode its address and activate the 
WAIT line if a wait is required. 




INTERRUPT REQUEST/ACKNOWLEDGE CYCLE 



The interrupt signal is sampled by the CPU with the 
rising edge of the last clock at the end of any instruction. 
When an interrupt is accepted, a spe cial M | cycle is 
generated. Durin g this M | cycle, the IORQ signal becomes 
active (instead of MREQ) to indicate that the interrupting 
device can place an 8-bit vector on the data bus. Two wait 
states (Tw*) are automatically added to this cycle so that a 
ripple priority interrupt scheme, such as the one used in the 
Z80 peripheral controllers, can be easily implemented. 
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A.C. Characteristics 



Z80CPU 



T A = 0°C to 70°C. Vcc = +5V ± 5%, Unless Otherwise Noted. 



Signal 


Symbol 


Parameter 


Min 


Mas 


Unit 


Test Condition 


* 


l w M>HI 
l w l*Ll 


Cluck Pc-ttod 

riiick Pulse Width. Cluck Iligli 
Clock ftilK Wldlll. Cluck Low 
Cluck Rise and Fall Tunc 


4 


1121 


usee 




IMJ 


|F| 


nsec 


SO 


:ooo 


nscc 




.'0 


■ «\ 


Vl5 


'DlADI 

'FiaOi 

'acili 

l ac i 

Cii 


Address Output Delay 

Delay 111 Floal 

Addtess Stable Pilot to MRFQIMemoty C>cle) 

Adtltess Stable Pilot toiORQ. RDut WRII Cycle! 

AddtessStableno.il RE. WR, IORQ or MREQ 

Address Stable From RD ot WR Dunn; Float 




145 


nsec 


C L =50pF 




110 


nsec 


III 




nsec 


l?l 




nsec 


131 




tlSCc 


Ul 




nsec 


D -1 


'DIDI 

'FIDI 

'S4MDI 

'S*IDl 

l dcm 

'del 

'cdl 


Data Output Delav 

Delay to Float Dunns! Write Cycle 

Data Setup Tune to Rising 1 dge ot Cluck During Ml Cycle 

Data Setup Time to Falling Edge ot Clock Duttng M2 to M5 

Data Stable Pilot to WR (Memory Cyclcl 

Data Stable Pilot to WR (I/O Cycle] 

Data Stable From WR 




230 


nsec 


C L =S0pF 




40 


nsec 


'0 




nscc 


oO 




nsec 


151 




nsec 


161 




rise* 


PI 








'H 


Any Hold Time lot Setup Tune 







nsec 




MREQ 


'DL*(MR| 

'DH»(MR> 

'DH*(MR> 

'wlMRLl 

'wIMRHl 


MRFQ Delay t-rum Falling tdge ol flock. MREQ Low 
MREO Delay From Rising Fdge of Clock. MREQ High 
MRFQ Delay Ftom Falling tdge of Clock. MRE'j High 
Pulse Width. MREO Low 
Pulse Width. MREO High 




100 


nsec 


C L ■ 50TF 




100 


nscv 




i66 


nsec 


IS1 




usee 


l«l 




nsec 


IORQ 


'DL»IIR| 
'DL*(IR> 
'DH*(IR) 
'DH0IIR) 


IOR0 Delay Ftom Rising Edge of Clock. IORQ Low 
10RO Delay Ftom Falling Edge of Clock, IORQ Low 
IORQ Delay From Rising Edge of Clock. IORQ High 
IOR0 Delay From Falling Edge of Clock. IORQ High 




00 


nsec 


C L ■ 50pF 




no 


nsec 




ISO 


nsec 




110 


nsec 


RD 


'DL»(RD| 
'DL0IRDI 
l DH*lRDt 
'DH*(RD| 


RD Delay From Rising Edge of Clock. RD Low 
RD Delay From Falling Edge of Clock. RD Low 
RD Delay Ftom Rising Edge of Clock. RD High 
RD Delay Ftom Falling Edge ol Clock. RD High 


, 


100 


nsec 


C L = SOpF 




1.10 


nsec 




160 


nsec 




no 


nsec 


WR 


'DL*(WR| 
'DL»(WR) 
'DH«(WR) 

: » iWRI 1 


WR Delay Ftom Rising Edge of Clock. WR Low 
WR Delay From Falling Edge of Clock. WR Low 
WR Delay From Falling Edge of Clock. WR High 
Pulse Width, WR Low 




80 


nsec 


C L = 50pF 




90 


nsec 




iM 


nsec 


I to) 




nsec 


KTT 


'DLIMII 
'DHfMll 


Ml Delay Ftom Rising Edge of Clock. Mf Low 
Ml Delay From Rising Edge of Clock. Ml High 




130 


nsec 


C L = S0pF 




IM 


nsec 


RFSH 


'DLlRFl 
'DHlRFI 


RFSH Delay From Rising Edge of Clock, RFSH Low 
RFSH Delay Ftom Rising Edge of Clock, RFSH High 




180 


nsec 


C L = 50pF 




l<0 


nsec 


waTF 


's(WT) 


WAIT Setup Time to Falling Edge of Clock 


70 




nsec 




halt 


'DIHTI 


HALT Delay Time From Falling Fdge of Clock 




300 


nsec 


C L * 50pF 


INT 


's(ITl 


[NT Setup Time to Rising Edge of Clock 


80 




nsec 




nm! 


'wINMLI 


Pulse Width. NMl Low 


80 




nsec 




BUSRO 


's(BQI 


BUSRQ Setup Time to Rising Edge of Clock 


80 




nsec 




BUSAK 


'DLIBAI 
'DHIBAI 


BUSAK Delay Ftom Rising Edge ol Clock. BUSAK Low 
BUSAK Delay Ftom Falling Fdge of Clock. BUSAK High 




i:o 


nsec 


C L = 50pF 




no 


nsec 


RESET 


'sIRSI 


RESET Setup Time lo Rising Edge of Clock 


°0 




nsec 






'F(C> 


Delay to Floal (MREO. IOR0. RD and WR) 




100 


nsec 






'mf 


Ml Stable Prior lo IORQ 1 Interrupt Ack.) 


mi 




nsec 





I"! Vwi.tHr'wI.I.Ll'V 



in 


'acm = , W*H>* 'l" 7S 


i=i 


'ac'i = "c ~*° 


i'i 


'ca^'wcM-l",- 40 


i->i 


Vaf-'wl^)",-" 


|5| 


•dem^c" 210 


M 


dci^wftPU*',- 210 


I 1 ! 


'cdf^'wCM-^'r"- 80 



l H l 'wlMRLl^'c" 



I'M 



'wtMRH) * 'wi<t>H, 



"°i VFRL) = , c- 40 



l"l 'rr 



NOTtS 

A Data should hi- enabled iinln Hie ("PI' d ata bus when RD i. active During interrupt acknowledge data 

should be enjhled when M I and IORQ -re both active '"<* 

B All control signals are internally synchronized, so they may be totally asynchronous with respect 
ii> ihechjck 

( The RtSEiT signal must be active ftM j minnnum ill i clock cwles 

D Output Delay vs Loaded Capacitance 
TA= 70"C Vcc = +5V tS 

Add I Onsec delay for each 50pf increase in load up to a maximum of 200pf for the data bus & 1 OOpf for 
address & control lines 
I- Although sialic by design, lesimg guarantee's l ^(b|-ii o 1 -OOu«c maximum 




OuTWjt . I 

^n 



Load circuit for Output 
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A.C. Timing Diagram 



Timing measurements are made at the following 

voltages, unless otherwise specified: "'" 

B CLOCK V C( .-.6V ,45V 

OUTPUT :.0V 8 V 

I , i INPUT 20 V 8 V 

" C FLOAT AV 10 5 V 

'w w). 



A 0-A15 



J 0-7' 



Ml 



RFSH 



RD 



"WI'HI 



WAIT 



BUSRQ 



BUSAK 



RESET 



\ 



"H 



— 'SI 10) — 



'OH (Ml)- 



±<r 



X 



^T" 



— w- r — 1> 



-SV- 



> 



X 



n 



■VH 



X 



— H'W IMRHI 



:>&: 



'WINMLip — -\ 



-sv- 
5 t4-ss- 



"3s 

7? . >r— ^ 



\ 



4V" 

"S-I-IDI — 



ltit 



>:_x. 



'OM'MRDI— 



-P^-H^. 



'DLI(IR) 



'OHI(RD)— 



X_ 



tH 




- 



j— -'OH'I-C 

K 



i) 



73tZ>C 



'S IHS) 



'OHIBAI, 



XZJC 
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Absolute Maximum Ratings 

Temperature Under Bias Spec i fie J operjiing rjnge 

Storage Temperature -b5°C to + 1 50°C 

Voltage On Any Pin -0.3V to +7V 

with Respect to Ground 

Power Dissipation 1.5W 



•Comment 

Stresses above those listed under "Absolute 
Maximum Rating" may cause permanent 
damage to the device. This is a stress rating 
only and functional operation of the device 
at these or any other condition above those 
indicated in the operational sections of this 
specification is not implied. Exposure to 
absolute maximum rating conditions for 
extended periods may affect device reliability. 



Note For Z80-CPU M AC and DC characteristics remain the 
same for the military grade parts except I 



Z80-CPU D.C. Characteristics 



T A -0'C 


to 70°C. V = 5V ♦ 5v; unless otherwise spec 


ned 










Symbol 


Parameter 


Min 


Typ 


Max 


Unit 


Test Condition 


V ILC 


Clock Input Low Voltage 


-0.3 




0.45 


V 




V IHC 


Clock Input High Vullage 


v cc "- 6 




V cc + - 3 


V 




v ll 


Inpul Low Voltage 


-03 




0.8 


V 




V IH 


Input High Voltage 


:.o 




V 

CC 


V 




V OL 


Oulpul Low Voltage 






04 


V 


l 0L =l 8mA 


V OH 


Output High Voliage 


:.4 






V 


'oh " - :50 " A 


'cc 


Power Supply Cuirenl 






ISO 


mA 




'l 1 


Inpul Leakage Current 






10 


"A 


V IN-°' oV cc 


'loh 


Tn-Slate Oulpul Leakage Cuirenl in Floal 






10 


"A 


v oi r •■■■"■ V., 


'km 


Tn Stale Oulpul Leakage Cuirent in Floal 






-10 


MA 


V OUT-° 4V 


'ld 


[>alj Bus Leakage Current in Input Mode 






±10 


JiA 


>>< V IN< V « 



Capacitance 

T A = 25°C.f= 1 MHz. 
unmeasured pins returned to ground 



Symbol 


Parameter 


Mix 


Unit 


c* 


Cluck Capacitance 


35 


PF 


C|N 


inpul Capacitance 


5 


pF 


C OUT 


Oulpul Capacitance 


10 


PF 



Z80-CPU 

Ordering Information 

C - Ceramic 

P - Plastic 

S - Standard SV ts%0° to 70°C 

E - Extended SV f S% -40° to 85°C 

M - Military SV l 10% -55° to I25°C 



Z80A-CPU D.C. Characteristics 



T A = C to -'{fi \ 



• unlcvi nine rv.i»e spi'Liited 



Symbol 


Parameter 


Min 


Typ 


Max 


Unit 


Test Condition 


V IL( 


Clock Inpul Lo« Voltage 


-0.1 




045 


V 




v lll( 


("luck Input Iligli Voltage 


V cc-6 




*«♦■' 


V 




V ll 


Inpul Low Voltage 


-0 .1 




OS 


V 




V IH 


Inpul High Voltage 


:o 




\ 


V 




V OI 


Oulpul Low Voltage 






04 


V 


1q. =1 8inA 


v OH 


Output Iligli Voltage 


: a 






V 


'till ' - :i0 " A 


'(i 


P.rwei SuppK Cuirenl 




90 


:oo 


mA 




'i I 


Inpul 1 eakage Current 






10 


UA 


V !N V 


'ion 


Tn Stale Ouipui 1 eakage C urrenl in Floal 






10 


u\ 


\„ I " \, 


'km 


In Si ale Output 1 eakage C lit tent in Float 






-10 


mA 


V n ,, r 4V 


'l 1) 


Djij riu^ Leakage ( urreill in Input Mode 






no 


«A 


U<V IN< V cc 



Capacitance 

T A = 25°C. I = I MHz. 
unmeasured pins returned In ground 



Symbol 


Parameter 


Max 


Unit 


<. p 


t lock t apacllance 


35 


pi 


( IN 


Input ( apacrlaUce 


< 


pi 


( Ot 1 


tkllpul Capacitance 


10 


I'l 



Z80A-CPU 
Ordering Information 



C Ceramic 

P Plastic 

S - Standard 5V 15% 0° to 70°C 
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A.C Characteristics 



Z80A CPU 



T A = 0°C to 70°C . Vcc = +5V ± 5'/,. Unless Otherwise Noted. 



Sit ail 


Symbol 


Parameter 


Min 


Mix 


Unit 


Test Condition 


* 


t w (»H> 
i w Ct>L) 
'i.l 


Clock Period 

Clock Pulse Width. Clock High 
Clock Pulse Widlh. Clock Low 
Clock Rise and Fall Time 


-25 


1121 


sisec 




110 


IE] 


nsec 


1 10 


:ooo 


•isC. 




JO 


nse^ 


Vl5 


'D(AD) 
'F(AD) 
'acm 

<a 
l c»f 


Address Output Delay 

Delay to Float 

Address Slabfe Prior to MREQ (Memory Cycle) 

Address Stable Prior to IORO, RD or WR ( I/O Cycle) 

Address Stable from RD. WR. IORO or MREO 

Address Stable From RD or WR During Float 




1 10 


nsec 


C|_ - SOpF 




90 


nsec 


III 




nsec 


l!l 




nse. 


131 




nsec 


Ml 




nsec 


D 0-7 


'D(D) 

'F(DI 

'S»(D) 

'S»(D1 

'dcm 

•dci 

■cat 


Data Output Delay 

Delay to Float During Write Cycle 

Data Setup Time to Rising tdge ol Clock Dunng Ml Cycle 

Data Setup Time to Falling Edge uf Clock During M2 to M5 

Data Stable Pnoi ro WR (Memory Cycle I 

Data Stable Pnoi to WR (I/O Cycle) 

Data Stable From WR 




150 


nsec 


C L =50pl 




90 


nsec 


!5 




nsec 


50 




nsec 


I<1 




nsec 


ISI 




nsec 


171 








'H 


Any Hold Time foi Setup Time 







nsec 




mrE<5 


'DL»(MR) 
'DH*(MR| 
'DH*(MRI 
'wflURLI 
•w (MRH| 


MREQ Delay From Falling Edge ol Clock. MREO Low 
MREQ Delay From Rising Edge of Clock. MREO High 
MREO Delay From Falling Edge of Clock. MREO High 
Pulse Widlh, MREQ Low 
Pulse Width, MREO High 




85 


nsec 


C L - 50pF 




85 


nsec 




85 


nsec 


181 




nsec 


ro 




nsec 


ioro 


'DL*(IR) 
'DL*(IR) 
'DH*(IRI 
'DH*(IRI 


IORO Delay From Rising Edge of Clock. IORO Low 
IORQ Delay From Falling Edge of Clock. IORO Low 
IORQ Delay From Rising tdge of Clock. IORQ High 
IORQ Delay From Falling Edge of Clock. IORQ High 




75 


nsec 


C L = 50pF 




85 


nsec 




85 


nsec 




85 


nsec 


RD 


'DL* (RD) 
'DL* (RD) 
'DH*(RD> 
■DH4>(RD) 


RD Delay From Rising Edge of Clock, RD Low 
RD Delay From Falling Edge of Clock. RD Low 
RD Delay From Rising Edge of Clock. RD High 
RD Delay From Falling Edge of Clock. RD High 




85 


nsec 


C L ■ 50pF 




95 


nsec 




S5 


nsec 




85 


nsec 


WR 


'DL*(WR) 
'DL*CWR) 
'DH*(WR) 
'wfWgL) 


WR Delay From Rising Edge ol Clock. WR Low 
WR Delay From Falling Edge of Clock. WR Low 
WR Delay From Falling Edge of Clock. WR High 
Pulse Width. WR Low 




65 


nsec 


C L = 50pF 




80 


nsec 




80 


nsi\ 


1101 




nsec 


5fl 


'DL(MI) 
'DH(MI) 


Ml Delay From Rising Edge of Clock. ST Low 
M 1 Delay From Rising Edge of Clock, M 1 High 




100 


nsec 


C L = 50pF 




100 


nsec 


RFSH 


'DL(RF) 
'DHIRF1 


RFSH Delay From Rising Edge of Clock. RFSH Low 
RFSH Delay From Rising Edge of Clock. RFSH High 




130 


nsec 


C L = 50pF 




120 


nsec 


WATT 


's(WT) 


WAIT Setup Time to Falling Edge of Clock 


70 




nsec 




halt 


'DIHTI 


HALT Delay Time From Falling Edge of Clock 




300 


nsec 


C L ■ SOpF 


INT 


's(lT> 


INT Setup Time to Rising Edge of Clock 


80 




nsec 




NMl 


'w(NML) 


Pulse Width. NMi Low 


80 




nsec 




BUSRO 


'i(BQ) 


BUSRO Selup Time to Rising Edge of Clock 


50 




nsec 




BUSAK 


'DL(BA) 
'DH(BA) 


BUSAK Delay From Rising Edge of Clock. BUSAK Low 
BUSAK Delay From Falling Edge of Clock. BUSAK High 




100 


nsec 


C L ■ 50pF 




100 


nsec 


RESET 


's(RS) 


RESET Selup Time to Rising Edge of Clock 


60 




nsec 






'Fto 


Delay to Float (MREO. iORQ. RD and WR) 




80 


nsec 






<mt 


Ml Stable Prior to IORQ (Interrupt Ack.l 


Mil 




nsec 





1 1 2] t c = t w (<t.HI* 'w(*L|* 'r*'f 



I'l 'acm = , w(*H]"f- 65 

121 We" 70 

l J l 'c a = , w(*L) + , r- 50 

1*1 'caf =, w,*L)*'r- 45 

I'l <dcm = >c-l 70 



l°] t 



dci " 'sv(*L) 



I'l 'wIMRLr'c- 30 

I'l 'wiMRHr'wftH)*'!- 20 



I") 1 m, l2l c , 'w(*H)* 1 ,- 65 



NOTES 

A. Data should be enabled onto the CPU d ata bus when RD is active. During interrupt acknowledge data 
should be enabled when"Ki7 and IORQ ate both active. 

B. All control signals are internally synchronized, so they may be totally asynchronous with respect 
to t he clock. 

C. The RESET signal must be active for a minimum of 3 clock cycles. 

D. Output Delay vs. Loaded Capacitance 

TA = 70°C Vcc = «5V±5* 

Add lOnsec delay for each 50pf increase in load up to maximum of 200pf for data bus and lOOpf for 

address & control lines. 

E. Although static by design, tcsnng guarantees t^^H) °f 200 ^sec maximum 




Load circuit for Output 
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NOTES 
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GLOSSARY 



ACCESS The operation of seeking, reading or writing data on a stor- 
age unit (in this case, the diskette) . 

ACCESS TIME The time that elapses between any instruction being 
given to access some data and that data becoming available for use. 

ACTIVE RECORDS TABLE (ART) A table of binary values in which the 
relative position of a single value determines the status of a record 
with the same relative position; i.e., the Nth binary number 
determines the status of the Nth record. EXAMPLE: If the 8th binary 
number in the table is a zero, then the 8th record is inactive. 
Conversely, if the 8th binary number in the table is a one, then the 
8th record is active. 

ADDRESS An identification (number, name, or label) for a location in 
which data is stored. 

ALGORITHM A computational procedure. 

ALPHANUMERIC (CHARACTERS) A generic term for numeric digits, alpha- 
betic characters, punctuation characters and special characters. 

ALPHANUMERIC STRING A group of characters which may include digits, 
alphabetic characters, punctuation characters and special characters, 
and may include spaces. (NOTE: a space is a 'character' to the 
computer, as it must generate a code for spaces as well as symbols.) 

ASCII Abbreviation for American Standard Code for Information 

Interchange. Pronounced: Ass-KEY. Usually refers to a standard 

method of encoding letter, numeral, symbol and special function 
characters, as used by the computer industry. 

ASSEMBLY LANGUAGE A machine level language for programming, such as 
Radio Shack's "EDI TOR/ ASSEMBLER" which uses Z-80 processor mnemonics 
and automatically 'assembles' machine readable code from the 
mnemonics. 

BASE A quantity of characters for use in each of the digital 
positions of a numbering system. 

BASE 2 The 'BINARY' numbering system consisting of more than one 
symbol, representing a sum, in which the individual quantity 
represented by each figure is based on a multiple of 2. 

BASE 10 The 'DECIMAL' numbering system - consisting of more than one 
symbol, representing a sum, in which the individual quantity 
represented by each symbol is based on a multiple of 10. 

BASE 16 The 'HEXADECIMAL' numbering system - consisting of more than 
one symbol representing a sum, in which the individual quantity 
represented by each symbol is based on a multiple of 16 . 
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BINARY See 'BASE 2' 

BIT A single 'BINARY' digit whose value is 'zero' or 'one*. 

BOOLEAN A form of algebra applied to binary numbers which is 
similar in form to ordinary algebra. It is especially useful for 
logical analysis of binary numbers as used in computers. 

•BOOT' - BOOTSTRAP A machine language program file that is put onto 
every diskette by the 'FORMAT' routine. This routing is invoked when 
reset or power-on occurs. It automatically loads the necessary 
programs (SYS0/SYS) to cause the computer to respond to the DOS 
commands; i.e., the machine is 'BOOTSTRAPPED' or 'BOOTED' into 
operation. 

BUFFER A small area of memory used for the temporary storage of 
data to be processed. 

BUFFER TRACK A track on a diskette used for the temporary storage of 
data or program material during a recovery process. 

BUG A software fault that results in the malfunction of a program. 
May also refer to hardware malfunctions. 

BYTE Eight "BITS'. A 'BYTE' may represent any numerical value 
between '0' and '255'. 

CLOBBERED A slang term referring to the non-operation of software, 
hardware, computer device, or storage media (such as disk) usually as 
the result of a program or hardware error. 

COMMAND FILE A file consisting of a list of commmands, to be executed 
in sequence. 

CONTIGUOUS Adjacent or adjoining. 

CONTROL CODE In programming, instructions which determine conditional 
jumps are often referred to as control instructions and the time 
sequence of execution of instructions is called the flow of control. 

CRC ERROR Cyclic Redundancy Check. A means of checking for errors by 
using redundant information used primarily to check disk I/O on the 

TRS-80. 

DATA BASE A collection of interrelated data stored together with 
controlled redundancy to serve one or more applications. The data are 
stored so that they are independent of programs which use the data. A 
common and controlled approach is used in adding new data and in 
modifying and retrieving existing data within a data base. A system 
is said to contain a collection of data-based information if they are 
disjoint in structure. 



314 



DATA BASE MANAGEMENT SYSTEM The collection of software required for 
using a data base. 

DATA ELEMENT Synonymous with 'DATA ITEM 1 or 'FIELD' 

DATA TYPE Tne form in which data is stored; i.e., integer, single 
precision, double precision, 'alphanumeric' character strings or 
'strings' . 

DEC Initials for Directory Entry Code. 

DECIMAL See 'BASE 10'. 

DIRECT ACCESS Retrieval or storage of data by a reference to its 
location on a disk, rather than relative to the previously retrieved 
or stored data. 

DIRECT STATEMENT (IN FILE) A program statement that exists in the 
disk file that is not assigned a line number. 

DIRECTORY A table giving the relationships between items of data. 
Sometimes a table or an index giving the addresses of data. 

DISPLACEMENT A specified number of sectors, at the top or beginning 
of the file, in which the 'bookkeeping' and file parameters are stored 
for later use by the various program modules. 

DISTRIBUTED FREE SPACE Space left empty at intervals in a data lay- 
out to permit the possible insertion of new data. 

DOUBLE PRECISION A positive or negative numeric value, 16 digits in 
length, not including a decimal point (EXAMPLE: 99999999999999.99). 

DUMP To transfer all or part of the contents of one section of 
computer memory or disk into another section, or to some other 
computer device. 

DYNAMIC STORAGE ALLOCATION The allocation of storage space by a pro- 
cedure based on the instantaneous or actual demand for storage space 
by that procedure, rather than allocating storage space to a 
procedure based on its anticipated or predicted demand. 

EATEN (DIRECTORY/DISK) Slang term. See 'CLOBBERED'. 

EMBEDDED POINTERS Pointers in the data records rather than in a di- 
rectory. 

ENTITY Something about which data is recorded. 

EOF Initials for 'END OF FILE'. It is common practice to say that 
the EOF is record number nn or that the EOF is byte 15 of sector 12. 
Hence, it is a convenient term to use in describing the location of 
the last record or last byte in a file. 
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EXTENT A contiguous area of data storage. 

FILE A collection of related records treated as a unit; The word 

file is used in the general sense to mean any collection of 

informational items similar to one another in purpose, form and 
content. 

FILE PARAMETERS The data that describes or defines the structure of 
the file. 

FILESPEC A file specification and may include the 'FILE NAME", 'FILE 
NAME EXTENSION' , 'PASSWORD', and 'DISK DRIVE' specification. 

FIELD See 'DATA ITEM'. 

FLAKY Slang term -Alludes to less than acceptable performance. 

FILE AREA The physical location of the file, on the disk, or in 
memory. 

'FPDE' Initials for File Primary Directory Entry; a file's entry and 
file area pointers in the disk directory. 

'FXDE' Initials for File Extended Directory Entry; a file's entry and 
file area pointers, in the case of an overflow in the 'FPDE*. 

GAT Initials for Granule Allocation Table; A table from which 
available file areas are assigned to file entries. 

GRANULE Unit of 5 sectors. On the TRS-80 disk operating system, a 
'granule' is the basic unit of disk storage allocation. The diskette 
'DIRECTORY' file keeps track of free and assigned disk space in terms 
of 'granules ' . 

HASH CODE A code number generated and used as a direct addressing 
technique in which the key is converted to a pseudo-random number from 
which the required address is derived. 

HEADER RECORD A record containing common, constant or identifying 
information for a group of records which follow. 

HEXADECIMAL See <BASE 16' 

HIT Initials for Hash Index Table; an addressing technique in which a 
disk file is referenced by a code number in a table, and the position 
of that code in the table relates to the file entry in the directory. 

INDEX A table used to determine the location of a record. 

INDIRECT ADDRESSING Any method of specifying or locating a storage 
location whereby the key (of itself or through calculation) does not 
represent an address. For example, locating an address through 
indices. 
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INSTRING (INSTRING SEARCH) Refers to the capability of locating a 
substring of characters that may exist in another character string. An 
example would be: Substring = "THE" String = "NOW IS THE TIME" . An 
INSTRING routine would locate the substring and return its starting 
position within that string. In this example, it would return a value 
of eight. 

INTEGER A natural or whole number. In the TRS-80, integer values may 
not exceed the range of +32767 to -32768. 

INVERTED FILE A file structure which permits fast spontaneous 
searching for previous unspecified information. Independent lists or 
indices are maintained in records' keys which are accessible according 
to the values of specific fields. 

INVERTED LIST A list organized by a secondary key not a primary 

key. 

IPL Initials for Initial Program Loader; a program usually executed 
upon pressing of the 'RESET' button. 

KEY A data item used to identify or locate a record or other data 
grouping. 

LABEL A set of symbols used to identify or describe an item, record, 
message or file. Occasionally, it may be the same as the address in 
storage. 

LEAST SIGNIFICANT BYTE The significant byte contributing the smallest 
quantity to the value of a numeral. 

LIST An ordered set of data items. A 'chain'. 

LOAD MODULE A program developed for loading into storage and being 
executed when control is passed to the program. 

LOCK-OUT (TRACKS) Unusable tracks, on the disk, that are not 
accessible because of damage or by user option. 

LOGICAL An adjective describing the form of data organization, 

hardware or system that is perceived by an application program, 

programmer, or user; it may be different than the real (PHYSICAL) 
form. 

LOGICAL DATA-BASE DESCRIPTION A schema. A description of the 
overall data-base structure, as perceived for the users, which is 
employed by the data base management software. 

LOGICAL FILE A file as perceived by an application program; it may 
be in a completely different form from that in which it is stored on 
the storage units. 
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LOGICAL OPERATOR A mathematical symbol that represents a 
mathematical process to be performed on an associated operand. Such 
operators are 'AND', 'OR', 'NOT', 'AND NOT' and 'OR NOT'. 

LOGICAL RECORD A record or data item as perceived by an application 
program; it may be in a completely different form from that in which 
it is stored on the storage units. 

LSB See LEAST SIGNIFICANT BYTE. 

MACHINE LANGUAGE Direct machine readable code. 

MAINTENANCE OF A FILE (1) The addition, deletion, changing or 
updating of records in the database. (2) Periodic reorganization of 
a file to better accommodate items that have been added. 

MONITOR A program that may supervise the operation of another program 
for operation or debugging or other purposes. 

MOST SIGNIFICANT BYTE The significant byte contributing the greatest 
quantity to the value of a numeral. 

MSB See MOST SIGIFICANT BYTE. 

MULTIPLE-KEY RETRIEVAL Retrieval which requires searches of data 
based on the values of several key fields (some or all of which are 
secondary keys) . 

NULL An absence of information as contrasted with zero or blank for 
the presence of no information. 

NYBBLE The four right most or left most binary digits of a byte. 

ON-LINE An on-line system is one in which the input data enter the 
computer directly from their point of origin, and/or output data are 
transmitted directly to where they are used. The intermediate stages 
such as writing tape, loading disks or off-line printing are avoided. 

ON-LINE STORAGE Storage devices and especially the storage media 
which they contain under the direct control of a computing system, not 
off-line or in a volume library. 

OPEN RECORDS TABLE (ORT) A table of binary values in which the 
relative position of a single value determines the status of a record 
with the same relative position; i.e., the Nth binary number 
determines the status of the Nth record. EXAMPLE: If the 8th binary 
number in the table is a zero, then the 8th record is open. 
Conversely, if the 8th binary number in the table is a one, then the 
8th record is on file. 

OPERATING SYSTEM Software which enables a computer to supervise its 
own operations, automatically calling in programs, routines, language 
and data as needed for continuous throughput of different types of 
jobs. 
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PARITY Parity relates to the maintenance of a sameness of level or 
count, i.e., keeping the same number of binary ones in a computer word 
and thus be able to perform a check based on an even or odd number for 
all words under examination. 

PHYSICAL An adjective, contrasted with logical, which refers to the 

form in which data or systems exist in reality. Data is often 

converted by software from the form in which it is physically stored 
to a form in which a user or programmer perceives it. 

PHYSICAL DATA BASE A data base in the form in which it is stored on 
the storage media, including pointers or other means of 
interconnecting it. Multiple logical data bases may be derived from 
one or more physical data bases. 

PHYSICAL RECORD A collection of bits that are physically recorded on 
the storage medium and which are read or written by one machine 
input/output instruction. 

POINTER The address or a record (or other data groupings) contained 
in another record so that a program may access the former record when 
it has retrieved the latter record. The address can be absolute, 
relative or symbolic, hence, the pointer is referred to as absolute, 
relative or symbolic. 

PRIMARY ENTRY The main entry made to the directory. Also see 'FPDE'. 

RANDOM ACCESS To obtain data directly from any storage location 
regardless of its position, with respect to the previously referenced 
information. Also called 'DIRECT ACCESS'. 

RANDOM ACCESS STORAGE A storage technique in which the time required 
to obtain information is independent of the location of the 
information most recently obtained. 

READ To accept or copy information or data from input devices or a 
memory register; i.e., to read out, to read in. 

RECORD A group of related fields of information treated as a unit by 
an application program. 

RELATIONAL OPERATOR A mathematical symbol that represents a 
mathematical process to perform a comparison describing the 
relationsnip between two values ( < less than....> greater than... = 
equal.... <> not equal... and combinations thereof (see TRS-80 LEVEL 
II manual, Section 1, Page 5). On the TRS-80, relational comparisons 
may be made on string values as well as numerical values. 

RELATIVE (as pertains to position) An address or position that is 
referenced to a point of origin; i.e. X+20 is a specific positon, 20 
places from the reference point. If the reference point was at 50, 
then the absolute position would be at 70 (50+20=70) . Also, 50 (since 
it is the starting reference point) is at relative position 0. 

SCHEMA A map of the overall logical structure of a database. 
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SEARCH To examine a series of items for any that have a desired 
property or properties. 

SECONDARY INDEX An index composed of secondary keys rather than 
primary keys. 

SECTOR The smallest addressable portion of storage on a diskette (a 
unit of 256 bytes on a TRS-80 diskette) . 

SEEK To position the access mechanism of a direct-access storage 
device at a specified location. 

SEQUENTIAL ACCESS Access in which records must be read serially or 
sequentially one after the other; i.e., ASCII files, tape. 

SINGLE PRECISION A positive or negative numerical value of 6 digits 
in length, not including a decimal point (EXAMPLE: 99999.9). 

SORT To arrange a file or data in a sequence by a specified key (may 
be alphabetic or numeric and in descending or ascending order) . 

SOURCE CODE The text from which code that may be executed is 
derived. 

SYSTEM FILE A program used by the operating system to manage the 
executing program and/or the computer's resources. 

SUB-STRINGS SUB-STRING SEARCH See INSTRING 

TABLE A collection of data suitable for quick reference, each item 
being uniquely identified either by a label or its relative position. 

TALLY To add or subtract a digit from a quantity. 

TOKEN A one byte code representing a larger word consisting of 2 or 
more characters. 

TRACK The circular recording surface traversed by a read/write head 
on the disk. On the TRS-80 a track contains 10 sectors (2 granules). 

TRANSACTION An input record applied to an established file. The 
input record describes some "event" that will either cause a new file 
record to be generated, an existing record to be changed or an 
existing record to be deleted. 

TRANSPARENT Complexities that are hidden from the programmers or 
users (made transparent to them) by the software. 

VECTOR A line representing the properties of magnitude and 
direction. Since such a 'line' can be described in mathematical 
terms, a mathematical description (expressed in numbers, of course) of 
a given 'direction' and 'magnitude* is referred to as a "vector". 
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VERIFY To check a data transfer or transcription. 

WORKING STORAGE A portion of storage, usually computer main memory, 
reserved for the temporary results of operations. 

WRITE To record information on a storage device. 

ZAP To change a byte or bytes of data in memory or on diskette by 
using a software utility program. 

ZEROETH Zeroeth is to '0' as first is to ' 1'; in computer terms the 
first position of anything is usually described as the 'zeroeth' and 
the next position is the 'first' and so on. 
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PARTS LIST 

SIMPLE HOBBYIST INTERFACE 



PARTS LIST 

QUAD SOUND, BOOPS AND BLEEPS GENERATOR 



IC 



TYPE 



+5 VOLTS 



Z1 


81LS95 


Z2 


B1LS96 


Z3 


B1LS95 


Z4 


81LS95 


Z& 


74LS75 


Z6 


74LS75 


Z7 


74LS30 


Z8 


74LS02 



20 
20 
20 
20 
5 
5 
14 
14 



IC 



PART 



CI 

C2 
C3 
C4 



TYPE 



+5 VOLTS 



Z1 


7805 


Z2 


74LS14 


Z3 


74LS90 


Z4 


74LS92 


Z5 


74LS74 


Z6 


74LS75 



3 
14 

5 

5 
14 

5 



(OUTPUT] 



VALUE 



NOTES 



4700 mf, 16 volts 
220 mf, 16 volts 
100 nf (0.1 mf) 
100 nf (0.1 mf) 



GROUND 



10 
10 
10 
10 
12 
12 
7 
7 



PARTS LIST 

ONE-SECOND INTERRUPT REAL-TIME CLOCK 



GROUND 



IC 



TYPE 



+5 VOLTS 



Z1 
Z2 
Z3 
Z4 
Z5 



74LS374 

74LS125 

74LS30 

74LS30 

7LS02 



20 
14 
14 
14 
14 



2 


Z1 


74LS30 


14 


7 


Z2 


74LS02 


14 


m 


Z3 


74LS00 


14 


in 


Z4 


74LS00 


14 


7 


zs 


74LS125 


14 


12 


Z6,7,8,9 


2114-AN4L 


18 




Z10 


2716 


24 



PART 



VALUE 



NOTES 



R1-R16 



1k0 (10,000 ohms) 



GROUND 



10 
7 
7 
7 
7 



PART 




VALUE NOTES 




R1-R5 




1k (10,000 ohms] 




PARTS LIST 
MEMORY SIDECAR 


ROM AND RAM ADDITION 




IC 


TYPE +5 VOLTS 


GROUND 



7 
7 
7 
7 
7 
9 
12 



PARTS LIST 

MUSIC SYNTHESIZER INTERFACE BOARD 



PARTS LIST 

MSM5B32 REAL-TIME CLOCK/CALENDAR 



IC 



TYPE 



+5 VOLTS 



GROUND 



Z1 


74LS30 


Z2 


74LS260 


Z3 


INS8255 


Z4 


MSM5832 



14 

14 



7 

7 

7 

13 



FART 



VALUE 



NOTES 



C1 
C2 
C3 
C4 
C5 
C6 
R1-R12 



20 pf 






20 pf 






100 nf 


(0.1 


mf] 


100 nf 


(0.1 


mf) 


100 nf 


(0.1 


mf J 


100 nf 


(0.1 


nf) 



10k (10,000 ohms) 



Battery backup: 

PART VALUE 



NOTES 



Cb 
C7 
C8 

eg 

D1 

D2 

U1 

Q2 

R13 

R14 

R15 

R16 

T1 

Z5 



470 Bif, 16 volts 

10 mf, 16 volts 

100 nf (0.1 mf) 

10 mf, 16 volts 

Bridge rectifier, 1A 50V 

1N914 or equivalent 

PNP transistor, Vce=0.1 volt 

NPN transistor 

47k (47,000 ohms) 

10k (10,000 ohms) 

10k [10,000 ohms) 

100R (100 ohms), 0.5 W 

6V3 (6.3 volt), 1A transformer 

7805 5-voLt regulator 



IC 



TYPE 



+5 VOLTS 



Z1 
Z2 
Z3 
Z4 
Z5 
Z6 
Z7 
Z8 
Z9 
Z10 



81LS95 

74LS1 54 

74LS00 

74LS04 

INS8255 

MC1408L8 OR DAC0808 



MC140BL8 OR DACDB08 13 



GROUND 



20 10 

24 12 

14 7 

14 7 

26 7 

13 2 
2 

74LS123 14 7 

74LS123 14 7 

LM324 4 11 

Note that Z6 and Z7 also require -15 volts on pin 

number 3 and and +7.5 volt reference at pin 14 
(through a variable resistor). 



FART 



VALUE 



NOTES 



C1,2 20 pf 

C3,4,5,6 100 nf (0.1 mf) (mey be changed) 

R1.3 4k7 (4700 ohms) 

R2,4 1k0 (1000 ohms) (mey be changed) 

R5,6,7,B 1M0 (1,000,000 ohms) 



PARTS LIST 

BANK-SELECT ROM/RAM ADDITION 



IC 



TYPE 



+5 VOLTS 



GROUND 



Z1 


81LS95 


Z2 


81LS95 


Z3 


81LS95 


Z4 


81LS95 


Z5-11 


2716 OR 4118 


Z12 


74LS20 


Z13 


74LS260 


Z14 


74LS02 


Z15 


74LS75 


Z16 


74154 


Z17 


74LS04 


Z18-26 


2716 OR 4118 



20 
20 
20 
20 
24 
14 
14 
14 

24 

14 
24 



10 

10 

10 

10 

12 

7 

7 

7 

12 

7 
12 
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PARTb LIST 

6-TRACK MASS STORAGE SYSTEM 



FARTS LIST 

4K DYNAMIC RAM ADDITION 



IC 



TYPE 



+5 VOLTS +12 VOLTS GROUND 



IC 



Z1 

22 

23 

24 

25 

26 

Z7 

28 

29 

Z10 

211 

Z12 

Z13 

Z14 



70C98/6DC98 

74LS04 

74LS125 

LF353 

LM339 

7DC98/8DC9B 

LF353 

74LS00 

75452 

70C96/80C96 

75452 

74LS373 

74LS30 

74LS04 



14 
14 



14 
B 

B 
20 
14 
14 



7 
4 

4 

10 

7 

7 



FART 



VALUE 



NOTES 



C1 

C2 

Lb 

C4 

Cb 

U6 

C7 

C8 

09,10,11 

C12 

D1 ,2,3,4,5 

K1,2,3 

R1,2,14,17, 

18,30,38,39, 

40,41 
R3,4,12,19, 

20,28 
R5,6,9,11 ,18, 

22,25,27,32 
R7,8,23,24 
R10,26 
R13.29 
R15.31 
R33 ,34,35,36, 

37,42 
R43 
R44 
SI 
S2 
S3 



100 pf 

220 pf 

220 nf (0.22 mf) 

10 mf, 16 volts 

1DD pf 

220 pf 

22D nf (0.22 of] 

10 mf, 16 volts 

100 nf (0.1 mf) 

470 mf, 35 volts 

1N914 or equivalent 

Minieture SPST 5-volt relay 



10k (10,000 ohms) 

470R (470 ohms) 

2k 2 (2200 ohms) 
220k [220,000 ohms) 
100k (100,000 ohms) 
22k (22,000 ohms) 
220R (220 ohms) 

1k0 (1000 ohms) 

100R (100 ohms) 

75R (75 ohms) May need aojustment 

Cartrioye-in-plece leaf switch 

Track change Liyht switch 

Split-pole foil sensor switch 



GROUND 



Z1 81LS95 20 10 

Z2 74LS157 16 8 

Z3 81LS95 20 10 

Z4 74LS157 16 8 

Z5 81LS95 20 10 

ZB-13 MK4114 4K RAMS 9 16 

Z14 74LS20 14 7 

Z15 74LSB6 14 7 

Z16 81LS95 20 10 

Note that Z6 through Z13 also require -5 volts on 

pin number 1 ano +12 volts on pin number 8. 



FART 



VALUE 



NOTES 



R1,2,3 
S1 



1k0 (1000 ohms) 
4-position DIP switch 



FARTS LIST 

HIGH-SPEED, REVERSE VIDEO, UPPER/LOWER CASE, 

INDIVIDUAL REVERSE VIDEO MODS 



IC 


TYPE 
2102-4L 








+5 VOLTS 




GROUND 


P45 (ZMEM) 


10 




S 


P25 tZBITS) 


74LS10 






14 




7 


P6 CZFAZE) 


74LS04 






14 




7 


P27 (ZMODE) 


74LS368 






20 




10 


P24 (ZMUXX) 


74LS86 






14 




7 


P26 IZFLOP) 


74LS74 






14 




7 


P53 (ZPORT) 


74LS02 






14 




7 


P44 (ZFAST) 


74LS367 






20 




10 


PC VERSION 


ONLY: 












Z25 


74LS04 






14 




7 


FART 


VALUE 






NOTES 




C1 


330 


Pf 










C2 


33 r 


if ( 


.033 


mf) 






R1 


10k 


(10 


,000 


ohms) 






VCR1 


100k 


: (100,000 ohms) 


Variebl 


e 



Miscellaneous: 

One 16-pin wire-wrap inteyrated circuit socket for 

piyyybackiny the PC board version onto Z45. 

No socket is needed for the hard-wired version. 



FARTS LIST 

MICRO FRONT PANEL MONITOR 



IC 



21 
22 
23 

24 



FART 



TYPE 



+5 VOLTS 



74LS373 
74LS373 
74LS373 
74LS20 



20 
20 
20 
14 



VALUE 



DIS1.2.3 

LED1-24 

R1-24 

R25,26,27,28 

S1 



GROUND 

10 
10 
10 

7 



NOTES 



10-seyment ber LED 
Subminiature LED 
270R (270 ohms) 
1k0 (1000 ohms) 
4-position DIP switch 



PARTS LIST 

HIGH-RESOLUTION GRAPHICS BOARD 

POWER SUPPLY 



PART 



C1 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 
R1 



VALUE 



NOTES 



4700 mf, 35 volts 
100 mf, 25 voLts 
100 nf (0.1 mf) 
10,000 mf, 35 volts 
100 mf, 16 volts 
100 nf (0.1 mf) 
470 mf, 16 volts 
100 mf, 16 volts 
100 nf (0.1 mf) 
220 ohms, 1/2 watt 
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PARTS LIST 

HIGH-RESOLUTION GRAPHICS BOARD 



IC 


TYPE 


+5 VOLTS 




GROUND 


Z1 


74LS04 




14 






7 


Z2 


74LS92 




5 






10 


Z3 


74LS74 




14 






7 


Z4 


74LS93 




5 






10 


Z5 


74LS93 




b 






10 


Z6 


74LS93 




5 






10 


Z7 


74LS93 




5 






10 


Z8 


74LS11 




14 






7 


ZS 


74LS02 




14 






7 


Z10 


74LS157 




16 






b 


Z11 


74LS157 




16 






8 


Z12 


74LS157 




16 






6 


Z13 


74LS157 




16 






B 


Z14 


74LS74 




14 






7 


Z15 


74LS00 




14 






7 


Z16 


74LS174 




16 






6 


Z17 


74LS166 




16 






B 


Z18 


74LS157 




16 






B 


Z19 


74LS157 




16 






B 


Z20 


74LS157 




16 






B 


Z21 


HK411B 




a 






16 


Z22 


MK4116 




& 






16 


Z23 


MK4116 




& 






16 


Z24 


MK4116 




s 






16 


Z25 


MK4116 




9 






16 


Z26 


HK4116 




& 






16 


Z27 


74C04 




14 






7 


Z28 


74C04 




14 






7 


Z29 


74C00 




14 






7 


Z30 


75452 




B 






4 


Z31 


74LS00 




14 






7 


Note that 


Z21 through Z26 


also 


need 


-a 


volts on pin 


number 1 , 


and +12 veLts on 


pin 


numbs 


ir i 

NO 1 


). 




PART 


VALUE 






rES 




C1* 


47 pf 




Minieture vari 


able 


C2 


10 nf (.01 


mf) 










L3 


10 mf, 16v 












04 


330 pf 




IDS 


or 


better 




C5 


47 nf (.047 mf] 


10% 


or 


better 




C6 


750 pf 




10X 


or 


better 




C7 


22 nf (.022 mf] 


10% 


or 


better 




Q1 


2N3904 




NPN 


switching 




02 


2N3S04 




NPN 


switching 




R1 


1kO (1000 


ohms) 










R2 


1kO (1000 


ohms) 










R3 


1kO [1000 


ohms) 










R4* 


S10R (910 


ohms) 










fib* 


91 OR (910 


ohms] 










RB 


1KB (1B00 


ohms) 










R7 


47R [47 ohmb) 










RB 


270R [270 


ohms) 










R9 


120R (120 


ohms) 










R10 


330R (330 


ohms) 










P11 


75R (75 ohms) 










R12 


10k (10,000 ohms] 








R13 


10k (10,000 ohn 


IE) 








VCR1 


100k [100 


,000 ohms) 


Variable 




VCR2 


100k [100 


,000 ohms) 


Variable 




X1» 


10.6445 MHz 










*Not needed if computer's 


internal 


clock is usee. 
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TRS-80 DISK 
AND OTHER MYST 



by H. C Pennington 

TRS-80 Disk and Other Mysteries is the definitive fix-it book for disk users. 
More than 1 30 pages of easy to read entertaining and immensely useful 
information. Find out how to recover disk files, the layout of information 
on disks, memory maps, problem solutions ... the list goes on! 

Many readers have saved days of work by recreating disk files that were 
unreadable. TRS-80 Disk and Other Mysteries, which has received 
favorable reviews inseveral magazines, isyoursforonly$22.50(plus$3.00 
shipping. CA residents add $1.35 sales tax. Canada add 20% for exchange 

rate.) 



TRS-80 is a trademark of Tandy 
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MICROSOFT BASIC 
DECODED 
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MICROSOFT. BASIC 

DECODED 

AND OTHER MYSTERIES 

by James Farvour 

Microsoft Basic and Other Mysteries is the definitive guide to your Level 1 1 
ROMs. With more than 7,000 lines of detailed comments and 6 additional 
chapters packed with information, it is easily the biggest and best book 
about the Level II ROMs available. 

Exploit the full power of Microsoft Basic with the aid of more than 300 
pages of tested examples, explanations, and detailed comments. Microsoft 
Basic and Other Mysteries is yours for only $29.95 (plus $3.00 shipping. 
CA residents add $1 .80 sales tax. Canadaa add 20% for exchange rate.) 

* TJM. Microsoft 
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BASIC FASTER AND BETTER 
AND OTHER MYSTERIES 

by Lewis Rosenfelder 

Basic is not nearly as slow as most programmers think. Basic Faster and 
Better shows you how to supercharge your BASIC with almost 300 pages 
of fast, functions and subroutines. 

You won't find any trivial poorly designed "check-book balancing" 
programs in this book— ifs packed with useful programs 

Tutorial for the beginner, instructive for the advanced, and invaluable for 
the professional, this book doesn's just talk ... it shows how! All routines 
are also available on disk, so that you can save hours of keyboarding and 
debugging. 

The #1 disk BFBDEM contains all the demonstration programs, and 
#2 disk BFBLIB has all the library functions. 

Basic Faster and Better is $29.95, and the two disks are $19.95 each 
(plus $3.00 shipping for book and disks together or separate. CA residents 
add $1 .80 sales tax for the book, disks add $1 .20 each. Canada add 20% 
for exchange rate.) 




ISBN 936200 02 2 



